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and performance is with the buyer. Should the programs prove defective following 
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and any incidental or consequential damages. In no event will Apple Computer 
Inc. be liable for direct, indirect, incidental, or consequential damages resulting 
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the possibility of such damages. Some states do not allow the exclusion or 
limitation of implied warranties or liability for incidental or consequential 
damages, so the above limitation or exclusion may not apply to you. 
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whole or part, be copied, photocopied, reproduced, translated or reduced to any 
electronic medium or machine readable form without prior consent, in writing, 
from Apple Computer Inc. 
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WARNING: This equipment has been certified to comply with the limits for a 
Class B computing device, pursuant to Subpart J of Part 15 of FCC Rules. Only 
peripherals (computer input/output devices, terminals, printers, etc.) certified to 
comply with the Class B limits may be attached to this computer. Operation with 
non-certified peripherals is likely to result in interference to radio and TV reception. 
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Apple II 



Super Serial Card 

Installation and Operating Manual 



Please read this manual before attempting to install the Super Serial 
Card in the Apple Computer. Incorrect installation could cause per- 
manent damage to both the Super Serial Card and the Apple. 



RADIO AND TELEVISION INTERFERENCE 

The equipment described in this manual generates and uses radio 
frequency energy. If it is not installed and used properly, 
that is in strict accordance with our instructions, it may 
cause interference to radio and television reception. 

This equipment has been tested and complies with the limits for 
a Class B computing device in accordance with the 
specifications in Subpart J of Part 15 of FCC rules. These 
rules are designed to provide reasonable protection against 
such interference in a residential installation. However, 
there is no guarantee that the interference will not occur in a 
particular installation. 

You can determine whether your computer is causing interference 
by turning it off. If the interference stops, it was probably 
caused by the computer. If your computer does cause 
interference to radio or television reception, you can try to 
correct the interference by using one or more of the following 
measures: 

- Turn the TV or radio antenna until the interference stops. 

- Move the computer to one side or the other of the TV or 
radio. 

- Move the computer farther away from the TV or radio. 

- Plug the computer into an outlet that is on a different 
circuit from the TV or radio. (That is, make certain the 
computer and the TV or radio are on circuits controlled by 
different circuit breakers or fuses.) 

If necessary, you should consult your dealer or an experienced 
radio/television technician for additional suggestions. You 
may find the following booklet prepared by the Federal 
Communications Commission helpful: 

"How to Identify and Resolve Radio-TV Interference Problems" 

This booklet is available from the U.S. Government Printing 
Office, Washington, DC 204(12, Stock number 004-000-00345-4. 
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PREFACE 



The Super Serial Card (SSC) provides a two-way serial interface to a 
wide variety of devices, including printers, terminals, plotters, 
and other computers. All these devices can be connected to the SSC 
either directly or via modem. 

The SSC replaces both the P8 and P8A variety of Apple II Serial 
Interface Card, although it does not manipulate all specific 
Apple II memory locations in the same way. The SSC also replaces 
the Apple II Communications Card, and supports Terminal Mode. 
Finally, the SSC supports Apple II parallel interface card software 
commands. 

The Super Serial Card conforms to the Electronic Industries 
Association (EIA) interface definitions A through E. (To obtain a 
copy of the EIA RS-232-C Standard, write to the EIA Engineering 
Department, Electronics Industries Association, 2001 Eye Street, 
N.W., Washington, D.C. 20006.) 

The SSC can be configured to the attached external device in three 
ways: (1) by setting switches on the card itself, (2) by typing in 
commands at the keyboard under the Monitor, Integer BASIC, Applesoft 
or DOS, or (3) by issuing commands from assembly language, BASIC or 
Pascal programs. The SSC can be configured and operated by programs 
in Integer BASIC, APPLESOFT, Pascal, and assembly language. 

How you prepare, install and use the Super Serial Card depends on 
what you connect to it: 

• Read Chapter 1 for unpacking and cable clamp preparation 
Instructions. 

• If you are going to connect a printer, terminal or some other 
device directly to the SSC, then read the first four sections 
of Chapter 2. (Many commonly used switch settings are listed 
in Table 2-1 for your convenience.) You only need to read 
the section Printer Mode Commands of Chapter 2 if you need 
special commands to change the SSC's characteristics. 

• If you are going to connect a device to the SSC via a modem 
or similar communications equipment, then read the first four 
sections of Chapter 3. (Switch settings for many 
Communications Mode applications are listed in Table 3-1.) 
You only need to read the section Communications Mode Commands 
of Chapter 3 if you need special commands to change the SSC's 
characteristics. 

• If you want to use the Apple II as an unintelligent terminal 
connected via a modem, read the section Terminal Mode of 
Chapter 3. 

• Troubleshooting Hints are discussed in Appendix E. 
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The SSC also emulates ("imitates") the Apple II Serial Interface 
Card (both the P8 and P8A varieties), and supports many of the 
software commands used by the Apple II parallel printer interface 
card and the Apple II Comrauni cat ions Card. These are all discussed 
in Appendix B. 

Chapter 4 explains how the SSC works, both in everyday terras (Serial 
Data Communication Simply Explained) and from an engineering 
viewpoint (Theory of Operation). The Theory of Operation section is 
keyed to the schematic diagram in Appendix C. Chapter 4 also 
contains a section on SSC modes and configurations. 

Appendix A discusses SSC firmware and its entry points in the SSC 
ROM, as well as the Apple II memory locations the firmware uses. 

Appendix C contains SSC specifications and connector pin 
assignments, and its schematic diagram. 

Appendix D lists the ASCII codes and their equivalents. Appendix E 
has troubleshooting hints. Appendix F explains the SSC error codes. 

A glossary explains the meaning of most Important terras as they 
apply to the SSC. 

The Reference Card summarizes the switch settings and commands for 
the SSC Printer Mode and Communications Mode. 

There are three symbols that set off information of special 
importance: 



This symbol points to a paragraph that contains especially 
useful Information. 



Watch out! This symbol precedes a paragraph that warns 
you to be careful. 



This symbol precedes a warning that you are about to harm 
hardware or destroy data. 
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CHAPTER 1 

GETTING STARTED 



This chapter takes you through the first steps of getting acquainted 
with your Super Serial Card (SSC). After unpacking the SSC and 
examining it, you will assemble the short internal cable (if it is 
not already assembled) that connects the 10-pin cable socket on the 
SSC to the 25-pin socket at the back of the Apple II case. 



UNPACKING 



As you unpack your Super Serial Card (Figure 1-1), check the 
contents against the items described on the packing list. 

Fill out the pre-addressed warranty card and mail it in. If any 
items are missing, contact the dealer you purchased the SSC from. 

You will need a shielded external cable (not provided as part of the 
SSC package) to connect the external device — the printer, modem, 
terminal, or other computer — to your Apple II. Suitable cables are 
available through your Apple dealer. 




Figure 1-1. Photo of the Super Serial Card 
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A CLOSE LOOK 



Let's examine the Super Serial Card for a moment. Pick up the SSC 
carefully and put it on a flat surface oriented as shown in Figure 
1-1. Now use Figure 1-2 to help identify the chief parts of the 
SSC. Those that you will have to deal with as you prepare it for 
installation are: 

• The jumper block . This ordinarily points toward the word 
TERMINAL; if you attach a modem to the SSC, you will turn this 
around so the arrow points toward the word MODEM (Chapter 3). 

• The switches . The left group is numbered from SU1-1 through 
SW1-7; the right group is numbered from SW2-1 through SW2-7. 
You can see the characters "SW1" and "SW2" printed on the SSC. 

• The edge connector . It is important not to touch the gold 
fingers on this connector: they must make a clean electrical 
contact in the Apple II connector slot when you install the 
SSC (Chapter 2 or Chapter 3). 

• The cable socket . The next section of this chapter explains 
how to install the short internal cable between the SSC and 
the Apple II case. 
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Figure 1-2. Line Drawing of the SSC 

PREPARING CABLE AND CLAMP ASSEMBLY 

Before preparing and installing the SSC, you may need to prepare the 
clamp assembly for the internal cable that will go from the SSC to 
the back of the Apple II' s case. The components of this clamp 
assembly are shown in Figure 1-3. If these components are already 
assembled, skip to the next section, Attaching the Internal Cable to 
the SSC. 
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Figure 1-3. Components of Internal Cable and Clamp Assembly 

Lay the short cable down as shown in Figure 1-3. Pick up the clamp 
piece that has the word TOP stamped on one end. Hold this clamp 
piece with the word TOP facing away from you, and the oval cutout 
toward the smaller connector on the cable. Bend the cable slightly, 
and insert it into the oval cutout through the opening; then 
straighten the cable in the cutout so that it moves easily. 

The other clamp piece has flanges (Figure 1-3) and a rectangular 
opening that is closer to one end (its top end) than to the other. 
Hold this clamp piece with its top end away from you and its flanges 
facing the 25-pin connector end of the cable. Then tilt the 
connector and feed it completely through the rectangular cutout. 

Now slide the two clamp pieces all the way down the cable until they 
are right up against the 25-pin connector, and their screw holes 
line up with the connector's screw holes. Slide the washers onto 
the screws and then thread the screws a couple of turns into the 
lined-up holes. Don't screw them in very far. 



ATTACHING INTERNAL CABLE TO SCC 

This step in the preparation of your Super Serial Card is simple to 
do, but you must do it carefully. 



It is very important to connect the cable to the SSC correctly. 
Improper connection of the cable to the SSC may result in 
damage to the Apple and the SSC; such damage is NOT covered by 
your warranty. 

Lay the SSC down on a flat surface, component-side up and gold 
fingers at the lower right. Examine the 10-pin end of the cable: 
the wires come out of the SIDE of the connector — the same side as 
the raised "key" in the plastic (Figure 1-3). Hold the connector so 
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the wires are on Che side away from the SSC, and insert the 
connector firmly into the cable socket along the right edge of the 
SSC. The raised "key" should slide into the groove in the cable 
socket (Figure 1-4). 



If the cable Is now jammed between the 10-pin cable socket and 
the SSC board, the connector is plugged in backwards. Unplug 
the connector and reconnect it so that the cable is on the side 
AWAY from the SSC (Figure 1-5). 




Figure 1-4. Sliding the "Key" into the Groove 




Figure 1-5. Internal Cable Attached Correctly to SSC 
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CHAPTER 2 

PRINTER MODE 



This chapter explains how to prepare, install and use the SSC in 
Printer Mode, and change the SSC's activities via commands. 



PREPARING THE SSC FOR PRINTER MODE 

The SSC is ready to operate in Printer Mode when the jumper block 
and switches SW1-5 and SW1-6 are correctly positioned (Figure 2-1). 

If the triangle on the jumper block is pointing down toward the word 
MODEM, remove the block (using an IC Extractor, if necessary) and 
carefully reinsert it so the triangle is pointing toward TERMINAL. 

Using a pointed object, set switch SW1-5 OFF and switch SW1-6 ON as 
shown in Figure 2-1. 
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Figure 2-1. SSC Set for Printer Mode 



When the jumper block is pointing toward TERMINAL, it is acting 
as a Modem Eliminator. Therefore, DO NOT connect a separate 
Modem Eliminator, or it will cancel the effect of the jumper 
block, and the attached device will not work. 
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SETTING THE SWITCHES 



Use a pointed object, such as the tip of a ballpoint pen, to flip 
the appropriate tiny switches on the SSC. A switch is ON when the 
top of the switch rocker is pushed in, and OFF when the bottom is 
in. The following subsections explain what settings to use. 

COMMONLY USED SETTINGS 

Table 2-1 lists the switch settings you can use for direct 
connection, via the SSC, of some commonly used printers. Most 
printers can use any one of several setups. 



Printer 



Switch Settings, Cable Connections, Other Information 



IDS 560 SW1_: OFF OFF OFF ON OFF ON ON SW2: ON ON * * OFF OFF OFF 

Paper Tiger Printer Mode, HW Hndshk, 9600 baud, 1 stop bit, ** width 

IDS SW1: ON ON OFF OFF SW2: OFF 

SSC/IDS pins: 3/3, 7/7, 20/20; all IDS jumpers removed 

NEC 5510 SVU : OFF ON ON ON OFF OFF OFF SW2: ON ON * * OFF OFF ON 

Spinwriter P8A Mode, ETX/ACK, 1200 baud, 1 stop bit, ** line width 
NEC switches: OFF ON OFF OFF OFF OFF ON ON 
SSC/NEC pins: 2/2, 3/3, 7/7, 20/6S8; 4&5 tied on NEC end 
May need keystroke to force first ETX after power-up. 

NEC 5510 SW1 : OFF ON ON ON OFF ON OFF SW2 : ON ON * * OFF OFF ON 

Spinwriter Printer Mode, hardware handshake, rest same as above 
NEC switches: OFF ON OFF OFF OFF OFF ON ON 
SSC/NEC pins: 3/3, 6/66.8, 7/7, 20/20; 4&5 NOT tied 

Qume SW1_: OFF ON ON ON OFF ON ON SW2: ON OFF * * OFF OFF OFF 

Sprint 5 Printer Mode, HW Hndshk, 1200 baud, 1 stop bit, ** width 

Qume switches: 1200 baud, no modem; pins: 3, 4, 7, 20 
Qume asserts RTS and DTR only when ready to receive data 

Qume SWl^: OFF OFF OFF ON OFF ON ON SW2 : ON OFF * * OFF OFF OFF 

Sprint 9/35 Printer Mode, HW Hndshk, 9600 baud, 1 stop bit, ** width 
Qume ETX-ACK/XON-XOFF switch set to ETX-ACK for HW Hndshk 



Table 2-1. Commonly Used Switch Settings for Printer Mode 

BAUD RATE 

No matter what type of printer or terminal you connect to the SSC, 
the SSC is going to pass information between the Apple II and the 
device at a certain prearranged speed, called the baud rate . Since 
the Apple II can usually send and receive information faster than 
what is connected to it, the simplest way to determine the baud rate 
is to consult the user manual for the device you will connect. Find 
out what rate is the fastest the device can handle (up to 19,200 
baud). Once you know this, you are ready to set the baud rate 
switches on the SSC. 
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Baud SW1-1 SW1-2 SW1-3 SW1-4 



Baud 



SW1-1 SW1-2 SW1-3 SW1-4 



50 
75 

110* 

135** 

150 

300 

600 



ON 
ON 
ON 
ON 
ON 
ON 
ON 



ON 

ON 

ON 

OFF 

OFF 

OFF 

OFF 



ON 

OFF 

OFF 

ON 

ON 

OFF 

OFF 



OFF 

ON 

OFF 

ON 

OFF 

ON 

OFF 



(* 109.92) 



(** 134.58) 



1200 
1800 
2400 
3600 
4800 
7200 
9600 
19200 



OFF 
OFF 
OFF 
OFF 
OFF 
OFF 
OFF 
OFF 



ON 

ON 

ON 

ON 

OFF 

OFF 

OFF 

OFF 



ON 

ON 

OFF 

OFF 

UN 

ON 

OFF 

OFF 



ON 

OFF 

ON 

OFF 

ON 

OFF 

ON 

OFF 



Table 2-2. Baud Rate Switch Settings 



k[«^ Make sure the printer or terminal you connect is set (with its 
V s own switches, dials or thumb wheels) to the SAME baud rate! If 

you don't, the SSC will send and receive unrecognizable 

garbage. 

DATA FORMAT AND PARITY 

The SSC sends each character (such as a "3" or an "F" or a Carriage 
Return) as a string of zeroes and ones ( bits ). The way it can 
send a character in Printer Mode, using switch settings, is this: 

• first a single start bit to signal to the printer or 
terminal that a character is coming; 

• then a string of 8 data bits representing the character; 

• no error-checking parity bit ; 

• one or two stop bits to signal the end of a character. 

For Printer Mode, the only aspect of the data format you can change 
with switch settings is whether to send one stop bit or two. If you 
set the baud rate switches to 50, 75 or 110 baud, set switch SW2-1 
OFF (two stop bits). For all other baud rates, set switch SW2-1 ON 
(one stop bit) unless the documentation for the device you are 
connecting specifies otherwise. 

The SSC does not send or check parity bits In Printer Mode unless 
you select some parity using the <n>P command, explained later in 
this chapter. 

CARRIAGE RETURN DELAY 

If you connect a slow printer to the SSC, and It has no handshaking 
capability, you may need to set switch SW2-2 ON to cause the Apple 
II to wait 1/4 second after a Carriage Return (<CR>). This gives 
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the print head assembly time to reposition to the beginning of the 
next line. Otherwise, set switch SW2-2 OFF (no delay). 

Additional delay values (32 ras and 2 s) are available via the <n>C 
command described later in this chapter. 

LINE WIDTH AND VIDEO ON/OFF 

Switches SW2-3 and SW2-4 determine the printer or terminal line 
width and also turn the Apple II video screen on or off. 

If you are connecting a printer to the SSC, select the appropriate 
switch settings for the number of characters the printer can fit on 
a line. If you set the line width to 40, the Apple II video screen 
is turned on, since it too can display 40 characters per line, and 
so can display an exact replica of what is being printed. 

If you plan to connect a terminal to the SSC, set the switches for 
the number of characters the terminal screen can display on a 
line — usually 72 or 80. For these line widths, the Apple II video 
screen is off. 



Line Width 



Video Screen SW2-3 



SW2-4 



40 char/line 

72 char/line 

80 char/line 

132 char/line 



on 
off 
off 
off 



ON 
ON 
OFF 
OFF 



ON 
OFF 
ON 
OFF 



Table 2-3. Line Width and Video Switch Settings 



The switch settings that turn off the Apple II video screen take 
effect only after PR// under BASIC or DOS. <CTRL-I> commands are 
still recognized, and cause the message APPLE SSC: to appear on the 
Apple II video screen. 

GENERATE <LF> OUT 

If you are connecting a printer to the SSC, check the printer's user 
manual to see if it automatically generates a linefeed (<LF>) after 
a carriage return (<CR». If it does not, set switch SW2-5 ON. 

If your printer does automatically generate a linefeed after a 
carriage return, or if you are connecting some other device that 
does not need automatic linefeed generation, set switch SW2-5 OFF. 

SPECIAL SWITCHES 

Switch SW2-6 controls forwarding of Interrupts to the Apple II. 
Since the Apple II and 11+ do not handle interrupts, set SW2-6 OFF. 
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Normally, switch SW1-7 is ON and switch SW2-7 is OFF. In the rare 
cases where the device uses pin 19, Secondary Clear To Send, in 
place of pin 4 or 20, Clear To Send, set SW1-7 OFF and SW2-7 ON. 

Your Super Serial Card is now ready to install and use In Printer 
Mode. 



INSTALLATION PROCEDURE 

This section explains how to install the SSC and its internal cable 
in the Apple II. If the cable clamp is not already assembled, do so 
now, following the Instructions given in Chapter 1. 



Before connecting or disconnecting anything on the Apple, turn 

off the power with the switch at the back left corner of the 

Apple case. THIS IS ABSOLUTELY NECESSARY. If you try to 

connect or disconnect anything from the inside of your Apple 

when the power is on, you are likely to damage the circuits. 

Do not unplug the Apple, just turn it off. If you unplug the Apple, 
you will isolate It from earth ground and leave it vulnerable to 
static discharges. 

Remove the Apple cover by pulling up on the two back corners of the 
cover until the two corner fasteners pop apart. Slide the cover back 
until it is free of the case and then lift the cover off. 

Look inside the Apple and locate the power supply case — the 
rectangular metal box along the left inside the Apple II. To avoid 
damaging the SSC, touch the power supply case with one hand; this 
discharges any static charge that may be on your clothes or body. 

Along the back inside edge of the Apple you will see eight long 
narrow slots called connector slots . The connector slots are 
numbered from at the left to 7 at the right. The numbers are 
printed along the back edge behind the connector slots. For use 
with Pascal, install the SSC in slot #1 for a printer, or slot #3 
for a terminal. For use with BASIC, install the SSC in any slot 
from #1 through 117. 



Handle the Super Serial Card as you would handle an expensive 

phonograph record. Grasp it only by the corners or edges, and 

do not touch the components or pins, especially the gold 
fingers on the edge connector. 

There are three deep notches along the back of the Apple II case. 
Temporarily set the SSC down near the desired slot. Then take the 
clamp assembly and slide it down into the notch closest to the slot 
that the SSC will be In. Tighten the screws until the connector 
assembly can no longer be moved In the opening. 
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Grasp the upper corners of Che SSC and insert the gold fingers of 
the edge connector into the slot in the back of the Apple, rear edge 
first. Gently push the front edge of the card down until it is 
level and firmly seated. 

Note that the outer ends of the screws in the clamp assembly can act 
as nuts. They are threaded and can receive screws from the printer 
or terminal connector, to ensure a good connection with the Apple. 




Figure 2-2. SSC in Slot #1 and Clamp Assembly in Notch 



Slide the Apple case top plate in place and press down on the rear 
corners until the corner fasteners pop into place. The Super Serial 
Card is now installed. 

EXTERNAL CABLE AND CONNECTOR 

The SSC cable connector you installed in the notch is a standard 
DB-25 connector with 25 pins. Ten pins of the connector are 
connected internally to the SSC. Connector pin assignments are 
listed in Appendix C. 

You will need a cable to connect your external device to the SSC 
connector on the Apple II. Shielded cables with 2 5-pin connectors 
on one end are available from your Apple dealer. 

The cable must have internal shielding, with the shielding properly 
terminated at both ends, to prevent electromagnetic interference to 
nearby radios, television sets, and communication equipment. This 
shielding is necessary for the system to comply with Class B Federal 
Communications Commission limits as defined by Subpart J of Part 15 
of the FCC rules. Unshielded cables are not recommended. 



Make sure that all devices are connected to the same grounded 
AC power circuit (three-wire wall outlet) as the Apple II. 
Connecting ungrounded equipment to your Apple II can cause 
severe electrical damage. 
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USING THE SSC IN PRINTER MODE 

Printer Mode allows you to use the SSC with a local (that is, 
directly connected) printer or terminal, as well as other local 
serial devices. After installing the SSC, you can control its 
operation from a BASIC, Pascal or assembly-language program, or even 
directly from the keyboard. The two parts of this section explain 
the easiest way to get the SSC up and running from the keyboard with 
a printer or terminal. 

WITH A PRINTER 

To use the SSC with a printer, do the following: 

• Make sure the jumper block points toward TERMINAL. 

• Under BASIC or DOS, boot the Apple II and then type in PR#s to 
send output to the printer (with the SSC in slot s). 

• Under Pascal, boot the Apple II and then use the F(iler 
T(ransfer command to send output data to #6: or PRINTER: 
(with the SSC in slot 9l). 

• If the printer doesn't work, refer to Appendix E for 
troubleshooting hints, or consult your Apple dealer. 

WITH A TERMINAL 

To use the SSC with a terminal, do the following: 

• Make sure the jumper block points toward TERMINAL. 

• Under BASIC or DOS, boot the Apple II and then type in PR#s 
and IN#s to route both input and output through the terminal 
(with the SSC in slot #s). 

• Under Pascal, boot the Apple II and then use the terminal as 
the input/output console (with the SSC in slot #3). 

• If the terminal doesn't work, refer to Appendix E for 
troubleshooting hints, or consult your Apple dealer. 



PRINTER MODE COMMANDS 

You can issue any of the commands described in this section by 
embedding them in a computer program. Under BASIC, DOS or the Apple 
Monitor, you can also enter them directly at the Apple (or terminal) 
keyboard. 
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In a BASIC program, put the control character and command in a PRINT 
statement. In a Pascal program, issue the command in a WRITE or 
WRITELN statement. 

When you enter the command character (usually <CTRL-I>; see below), 
the prompting message APPLE SSC: appears on the display screen. 
Subsequent characters, up to <RETURN>, will be interpreted as an SSC 
command. Pressing the left arrow key before pressing <RETURN> 
cancels the command and causes the APPLE SSC: prompt to reappear. 

Many of these commands override the physical switch settings on the 
SSC. This makes it unnecessary to open the Apple II case and 
manually flip the SSC switches. To change the values back to the 
physical switch settings, reboot or reset the Apple II, or type in 
the Reset command described below. 

COMMAND FORMATS 

All commands are preceded by the Printer Mode command character 
(usually <CTRL-I>, see below) and followed by <RETURN>. The 
notation <CTRL-I> means "hold down the CTRL key while pressing I." 
There are three types of command formats: 

• a number <n> followed by an uppercase letter (for example, 4D 
to set Data Format 4) 

• simply an uppercase letter (for example, R to Reset the SSC) 

• an uppercase letter followed by a space and then either E to 
Enable or D to Disable a feature (for example, L D to Disable 
automatic generation of linefeed characters) 

The allowable range of <n> is given in each command description (next 
section). The choice of Enable or Disable is indicated as <E/D>. 



!! 
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If you want to change the command character from <CTRL-I> to 
<CTRL-some thing else>, type <CTRL-IXCTRL-some thing else>. For 
example, to change the command character to <CTRL-W>, type 
<CTRL-IXCTRL-W>. To change back, type <CTRL-WXCTRL-I>. No 
<RETURN> is required after either of these commands. 

The command character <CTRL-I> is ASCII code 9. Here is how to 
generate this character in BASIC and Pascal: 



Integer BASIC: 
Applesoft BASIC: 
Pascal: 



PRINT "*coramand" *embedded <CTRL-I> 
PRINT CHRS(9): "command" 
WRITELN (CHR(9), 'command'); 



PRINTER MODE COMMAND SUMMARY 

Table 2-4 is a summary of the commands available in Printer Mode. 
Some details, explained fully in the remainder of this chapter, have 
been omitted from the table for the sake of brevity. Commands 
marked with an asterisk are not supported by Pascal. 



The underscore character (_) before the <E/D> in Enable/Disable 
commands Is merely a reminder that a space is required there. 

The SSC checks only numbers and the first letters of commands and 
options. All such letters must be uppercase. Further letters, 
which you can add to assist your memory, have no effect on the SSC 
For example, X(OFF E(nable is the sane as X E. The SSC ignores 
invalid commands. 

THE COMMAND CHARACTER 

The normal command character in Printer Mode is <CTRL-I> (decimal 9; 
Appendix D). You can send the command character itself through the 
SSC by typing it twice in a row: <CTRL-IXCTRL-I>; no <RETURN> is 
required after this command. This special command allows you to 
transmit the command character without affecting the operation of 
the SSC, and without having to change to another command character 
and then back again later. 
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Format 


Command Name 


Values 


Interpretation 




<n>B 


Baud Rate 


0-15 


see Table 2-5 




<n>C 


<CR> Delay 



1 
2 
3 


no delay 

32 milliseconds 

250 milliseconds (1/4 s) 

2 seconds 




<n>D 


Data Format 


9 
l 
2 
3 

4 
5 
6 

7 


8 data bits, 1 stop bit 

7 data bits, 1 stop bit 

6 data bits, 1 stop bit 

5 data bits, 1 stop bit 

8 data bits, 2 stop bits 

7 data bits, 2 stop bits 

6 data bits, 2 stop bits 
5 data bits, 2 stop bits 




<n>F 


<FF> Delay 



1 
2 
3 


no delay (default) 

32 milliseconds 

250 milliseconds (1/4 s) 

2 seconds 




<n>L 


<LF> Delay 



1 
2 
3 


no delay (default) 

32 milliseconds 

250 milliseconds (1/4 s) 

2 seconds 




<n>P 


Parity 


0,2,4,6 
1 
3 
5 

7 


no parity (default = 0P) 

odd parity 

even parity 

MARK (parity bit always 1) 

SPACE (parity bit always 0) 




* <n>T 


Translate 
Lowercase (LC) 



1 
2 
3 


change LC to UC (default) 
leave LC (possible garbage) 
LC to UC inverse; leave UC 
LC to UC; UC to inverse 




* C 

* R 
Z 


Column Overflow 
Reset the SSC 
Zap <CTRL> 




auto-<CR> at column's end 
reset SSC + PR#0 and IN//0 
ignore all <CTRL> commands 




F <E/D> 
L <E/D> 
M <E/D> 

* T <E/D> 
X_<E/D> 

* Not supp 


Find Keyboard 
Generate <LF> Out 
Mask <LF> In 
Tab In BASIC 
XOFF Recognition 
orted by Pascal. 


E or D 
E or D 
E or D 
E or D 
E or D 


accept keyboard entries 
send <LF> out after <CR> 
drop <LF> in after <CR> 
recognize BASIC tabs 
detect XOFF; await XON 





Table 2-4. Printer Mode Commands 
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COMMANDS THAT CHANGE SWITCH SETTINGS 

The group of commands discussed in this section either directly 
override the SSC switch settings, or affect related behavior of 
the SSC. The Reset command restores the switch selections. 

Baud Rate-<n>B 

This command overrides the physical settings of switches SW1-1 
through SW1-4 on the SSC. For example, to change the baud rate to 
135 baud, type in <CTRL-I>4B<RETURN>. 



<n>= 


SSC Baud Rate 


<n>= 


SSC Baud Rate 





use SW1-1 to SW1-4 


8 


1200 


1 


50 


9 


1800 


2 


75 


10 


2400 


3 


109.92 (110) 


11 


3600 


4 


134.58 (135) 


12 


4800 


5 


150 


13 


7200 


6 


300 


14 


9600 


7 


600 


15 


19200 



Table 2-5. Baud Rate Selections 



Data Format-<n>D 



With this command you can override the settings of switch SW2-1. 
The table below shows how many data and stop bits correspond to each 
value of <n>. For example, <CTRL-I>2D<RETURN> causes the SSC to 
transmit each character in the form: one start bit (always 
transmitted), six data bits, and one stop bit. 



<n>= 



Data Kits Stop Kits 



1 

1 

1 

1 

2 (1 with Parity options 4 through 7) 

2 

2 

2 (1-1/2 with Parity options through 3) 



Table 2-6. Data Format Selections 



Parity-<n>P 



You can use this command to determine the kind of parity the SSC is 
to generate when sending data and check for when receiving data. In 
general, parity checking is not needed in Printer Mode. However, 
there are five parity options available (Table 2-4). 



PRINTER MODE 15 



<n> = 



Parity to Use 



0, 2, 4 or 6 none (default value) 

1 odd parity (odd total number of ones) 

3 even parity (even total number of ones) 

5 MARK parity (parity bit always 1) 

7 SPACE parity (parity bit always 0) 



Table 2-7. Parity Selections 



For example, type <CTRL-I>1P<RETURN> to cause the SSC to transmit 
and check for odd parity. Odd parity means that the high bit of 
every character is if there is already an odd number of 1 bits 
in that character, or 1 if there is otherwise an even number of 

I bits in the character, making the total always odd. This is an 
easy (but not foolproof) way to check data for transmission errors. 
Parity errors are recorded in a status byte (Appendix F). 

Set Time Delay- <n>C, <n>L, <n>F 

Some printers are slow and do not provide a "printer busy" or 
handshake signal to the Apple II. The <n>C command causes the Apple 

II to delay a specified amount of time, after sending a carriage 
return character, before sending another group (usually another line) 
to it. This gives the print head enough time to return to the left 
side of the page so it Is ready to continue printing. 

The <n>C command overrides the setting of switch SW2-2 on the SSC. 
That switch provides only two choices: no delay or a 250 millisecond 
delay. 

The <n>L command allows time after a linefeed character for a printer 
platen to turn so the paper is vertically positioned to receive the 
next line. 

The <n>F command allows time after a form feed character for the 
printer platen to move the paper form to the top of the next page 
(typically a longer time than a linefeed). 



<n>= 



Time Delay 



none 

32 milliseconds 

250 milliseconds (1/4 second) 

2 seconds 



Table 2-8. Time Delay Selections 
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Consult the user manual for the printer to find out how much time it 
takes to move its print head and platen, and so to determine an 
appropriate set of values for these three delays. The idea is to 
have at least enough time for the printer parts to move the required 
distance, but not so much time that overall printing speed is slowed 
down drastically. A typical set for a VERY slow printer would be 
<CTRL-I>2C<RETURN> , <CTRL-I>2L<RETURN> ,<CTRL-I>3F<RETURN>; that is, 
the SSC waits 250 milliseconds after transmitting carriage returns, 
250 milliseconds after transmitting linefeeds, and 2 seconds after 
transmitting form feed characters. 

Generate <CR> On Column Overflow-C 

Typing <CTRL-I>C<RETURN> causes the SSC to generate a carriage 
return character automatically any time the column count exceeds the 
printer line width. 



Once this is on, only clearing the high-order bit at location 
$578+s (where s is the slot the SSC is in) can turn this option 
back off. This option is normally off. 



Generate <LF> Out-L_<E/D> 



You can use this command to have the SSC automatically generate and 
transmit a linefeed character after each carriage return character. 
This overides the setting of switch SW2-5. For example, you can 
type <CTRL-I>L E<RETURN> to cause your printer to print listings or 
double-spaced manuscripts for editing. 

Mask (Suppress) <LF> ln-M_<E/D> 

If you type <CTRL-I>M E<RETURN>, the SSC will suppress any incoming 
linefeed character that immediately follows a carriage return 
character. 

Reset the SSC-R 

Typing <CTRL-I>R<RETURN> has the same effect as sending a PR#0 and 
an IN#0 to a BASIC program and then resetting the SSC. This 
keyboard command cancels all previous commands to the SSC and puts 
the physical switch settings back into force. 

OTHER COMMANDS 

The commands described here affect the handling of characters and 
tabs. The Translate command determines how characters will appear 
on the video screen. The Z and F commands prevent the SSC from 
responding to control characters or ALL characters coming from the 
keyboard, respectively. The X command causes the SSC to respond to 
the XON/XOFF software protocol. Finally, the T command implements 
the tabbing feature of BASIC. 
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Translate Lowercase Characters-<n>T 

The Apple II Monitor "translates" all incoming lowercase characters 
into uppercase ones before sending them to the video screen or to a 
BASIC program. The SSC offers four translation options: 



<n>= 



What to Do with Lowercase Characters 



Change all lowercase characters to uppercase ones before 
passing them to a BASIC program or to the video screen. 
This is the way the Apple II monitor handles lowercase. 

Pass along all lowercase characters unchanged. The 
appearance of the lowercase characters on the Apple II 
screen is undefined (garbage). 

Display lowercase characters as uppercase inverse characters 
(that is, as black characters on a white background). 

Pass lowercase characters to programs unchanged, but display 
lowercase as uppercase, and uppercase as inverse uppercase 
(that is, as black characters on a white background). 



I 



•J 






^ 



until the SSC receives an XON (decimal 17; Appendix D) from the 
device, signalling the SSC to continue transmission. In Printer 
Mode, the default value of this command is X D. 



In Printer Mode, full duplex communication may not work with 
XOFF recognition turned on, so be careful. 

Tab in BASIC-T_<E/D> 

If you type in <CTRL-I>T E<RETURN>, the BASIC horizontal position 
counter is left equal to the column count. All TABs work, including 
back-tabs. TABs beyond column 40 require a POKE to location 36, as 
usual. Commas only work as far as column 40, and BASIC programs 
will be listed in 40-coluran format. 



Table 2-9. Lowercase Character Displays 

Zap (Suppress) Control Characters-Z 

Typing <CTRL-I>Z<RETURN> prevents the SSC from recognizing any 

further control characters (and hence commands) whether coming from 

the keyboard or contained in a stream of characters moving through 
the SSC. 

If you issue the Z command described here, all further commands are 
ignored; this is useful if the data you are transmitting contains 
bit patterns that the SSC can mistake for control characters. 

rCi^7 Th e only way to reinstate command recognition after the Z 

^— s command is to reinitialize the SSC, or clear the high-order bit 

at location $5F8+s (where s is the slot in which the SSC is 

installed). 

Find Keyboard-F_<E/D> 

You can protect incoming data from disruption by keystrokes with 
this command. For example, you can include an F D command in a 
program, followed by a routine that retrieves data coming in through 
the SSC, followed by F E later in the program. Default is F E. 

XOFF Recognition-X_<E/D> 

Typing <CTRL-I>X E<RETURN> causes the SSC to look for any XOFF 
(decimal 19; Appendix D) character coming from a device attached to 
the SSC, and to respond to it by halting transmission of characters 
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CHAPTER 3 

COMMUNICATIONS MODE 



This chapter explains how to prepare, install and use the SSC in 
Communications Mode, and change the SSC's activities via commands. 



PREPARING THE SSC FOR 
COMMUNICATIONS MODE 

The SSC is ready to operate in Communications Mode when the jumper 
block and switches SW1-5 and SW1-6 are correctly positioned. 

If the triangle on the jumper block is pointing up toward the word 
MODEM, remove the block (using an IC Extractor, if necessary) and 
reinsert it with the triangle pointing toward MODEM (Figure 3-1). 

Using a pointed object, set switches SW1-5 and SW1-6 both ON as 
shown in Figure 3-1. This puts the SSC in Communications Mode. 






■ I 



ACIA 



aaa 



A! 



can t=n 



ROM 



U 



Edge Connector i 



^^ Fingers > 

-1 MM II llllllllll 

Figure 3-1. SSC Set for Communications Mode 
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SETTING THE SWITCHES 



Use the tip of a ballpoint pen or some other sharp object to flip 
the appropriate tiny switches on the SSC. A switch is ON when the 
top of the switch rocker is pushed in. The following subsections 
explain what settings to use. 

COMMONLY USED SETTINGS 

Table 3-1 lists the switch settings you can use for connection to 
various devices and services via the SSC and a modem. 

Application Switch Settings, Cable Connections, Other Information 

Apple II SW1_: ON OFF OFF ON ON ON ON SW2 : ON ON * * OFF OFF OFF 

via modem Comm Mode, 300 baud, 8 data, 1 stop, * * parity 

If using SSC in each Apple, set both the same; for local 
connection, second jumper block points toward TERMINAL. 

Apple III SW1 ; ON OFF OFF ON ON ON ON SW2: ON ON * * OFF OFF OFF 

via modem Comm Mode, 300 baud, 8 data, 1 stop, * * parity 

Set Apple III RS-232-C Device Control Block to same 
values (See Apple III Standard Device Drivers manual). 

Printer SW1 ; ON OFF OFF ON ON ON ON SW2 : ON OFF * * OFF OFF OFF 

via modem Comm Mode, 300 baud, 7 data, 1 stop, * * parity 

Baud rate is limited by modem and transmission lines; 
some modems can also use 1200 baud; SW1-7 is always ON, 
and SW2-7 is always OFF; SCTS hookup is at remote modem. 

Dow Jones SW1_: ON OFF OFF ON ON ON ON SW2: ON OFF - ON OFF OFF OFF 

News and Comm Mode, 300 baud, 7 data, 1 stop, no parity 

Quotes Sample program at end of this chapter sets same traits. 

Reporter Use T command for Terminal Mode operation. 

Table 3-1. Commonly Used Switch Settings for Communications Mode 



Make sure that the settings on the SSC, modem and remote device are 
all compatible. Successful operation using a modem depends on this. 

After setting the switches on the SSC, you can go on to the next 
major section of this chapter, Installation Procedure. 

BAUD RATE 

No matter what kind of modem and remote device you connect to the 
SSC, the SSC Is going to pass information between the Apple II and 
the device at a certain prearranged speed, called the baud rate . 
Since the Apple II can usually send and receive information faster 
than what is connected to it, the simplest way to determine the 
maximum baud rate you can use is to consult the user manual for the 
modem and remote device you will connect. Find out what rate is the 
fastest they both can handle. Once you know this, you are ready to 
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set the baud rate switches on the SSC. 
the correct switch positions. 



The following table shows 



Baud SW1-1 SW1-2 SW1-3 SW1-4 



Baud 



SW1-1 SW1-2 SW1-3 Swl-4 



50 

75 
110* 
135** 
150 
300 
600 



ON 
ON 
ON 
ON 
ON 
ON 
ON 



ON 

ON 

ON 

OFF 

OFF 

OFF 

OFF 



ON 

OFF 

OFF 

ON 

ON 

OFF 

OFF 



OFF 

ON 

OFF 

ON 

OFF 

ON 

OFF 



(* 109.92) 



(** 134.58) 



1200 
1800 
2400 
3600 
4800 
7200 
9600 
19200 



OFF ON 

OFF ON 

OFF ON 

OFF ON 

OFF OFF 

OFF OFF 

OFF OFF 

OFF OFF 



ON 

ON 

OFF 

OFF 

ON 

ON 

OFF 

OFF 



ON 

OFF 

ON 

OFF 

ON 

OFF 

ON 

OFF 



Table 3-2. Baud Rate Switch Settings 



(<5]>) If you are connecting a printer or terminal at the other end of 
^ — ' the modem, make sure that it is set (with its own switches, 
dials or thumb wheels) to the SAME baud rate! If you don't, 
the SSC will send and receive unrecognizable garbage. 

DATA FORMAT AND PARITY 

The SSC sends each character (such as a "7" or an "H" or a "?") as a 
string of zeroes and ones ( bits ). The way it can send a character 
in Communications Mode, using switch settings, is this: 

• first a single start bit to signal to the printer or 
terminal that a character is coming; 

• then a string of 7 or 8 data bits representing the character; 

• possibly a parity bit for error checking; 

• lastly one or two stop bits that signal the end of a 
character. 

For Communications Mode, you can use switch settings to change three 
aspects of the data format: the number of data bits, the number of 
stop bits, and the kind (if any) of parity bit to send. Switches 
SW2-1 through SW2-4 determine the data format as shown in this table. 



Stop 

Bits SW2-1 



Data 

Bits SW2-2 



Parity 

Bits SW2-3 SW2-4 



ON 
OFF 



ON 
OFF 



none 

odd 

even 



ON 
ON OFF 

OFF OFF 



Table 3-3. Data Format Selections 
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If SW2-1 is OFF, the number of stop bits will be 1 instead of 2 if 
both 8 data bits (SW2-2 ON) and a parity bit (SW2-4 OFF) have been 
selected. 

To determine the correct combination of switch settings, consult the 
literature describing the device or timesharing service you plan to 
connect to the SSC in this mode. 

The most commonly used format for ASCII data is: 7 data bits, I 
stop bit, and no parity bit (SW2-1 and SW2-4 ON; SW2-2 OFF). 

If you set the data rate switches to 50, 75 or 110 baud, choose a 
switch combination that specifies 2 stop bits; for all data rates 
135 baud or higher, use 1 stop bit (switch SW2-1 ON), unless device 
or timesharing service literature specifies otherwise. 

To set the SSC for a data format different from those shown in 
this table, or to change the data format temporarily, use the 
SSC commands described later in this chapter. 

GENERATE <LF> OUT 

If the remote device (for example, a faraway printer) does not 
automatically generate linefeeds after carriage returns, and it 
desperately needs them, then set switch SW2-5 ON. Otherwise set 
SW2-5 OFF. 

In Communications Mode, the SSC automatically discards incoming 
linefeeds that immediately follow carriage returns, unless you use 
the M D command as described later in this chapter. 

SPECIAL SWITCHES 

Switch SW2-6 controls forwarding of interrupts to the Apple II. 
Since the Apple II and 11+ do not handle interrupts, set SW2-6 OFF. 

For Communications Mode, set SW1-7 ON and SW2-7 OFF. 

Your Super Serial Card is now ready to install and use in 
Communications Mode. 



INSTALLATION PROCEDURE 



This section explains how to install the SSC and its internal cable 
in the Apple II. If the cable clamp is not already assembled, do so 
now, following the instructions given in Chapter 1. 



sl 

a 
a 

si 
H 

- 



Before connecting or disconnecting anything on the Apple, turn 
off the power with the switch at the back left corner of the 
Apple case. THIS IS ABSOLUTELY NECESSARY. If you try to 
connect or disconnect anything from the inside of your Apple 
when the power is on, you are likely to damage the circuits. 

Do not unplug the Apple, just turn it off. If you unplug the Apple, 
you will isolate it from earth ground and leave it vulnerable to 
static discharges. 

Remove the Apple cover by pulling up on the two back corners of the 
cover until the two corner fasteners pop apart. Slide the cover back 
until it is free of the case and then lift the cover off. 

Look inside the Apple and locate the power supply case — the 
rectangular metal box along the left inside the Apple II. To avoid 
damaging the SSC, touch the power supply case with one hand; this 
discharges any static charge that may be on your clothes or body. 

Along the back inside edge of the Apple you will see eight long 
narrow slots called connector slots . The connector slots are 
numbered from at the left to 7 at the right. The numbers are 
printed along the back edge behind the connector slots. For use 
with Pascal and a modem, install the SSC in slot #2. For use with 
BASIC, install the SSC in any slot from #1 through #7. 



Handle the Super Serial Card as you would handle an expensive 
phonograph record. Grasp it only by the corners or edges, and 
do not touch the components or pins, especially the gold 
fingers on the edge connector. 

There are three deep notches along the back of the Apple II case. 
Temporarily set the SSC down near the desired slot. Then take the 
clamp assembly and slide it down into the notch closest to the slot 
that the SSC will be in. Tighten the screws until the connector 
assembly can no longer be moved in the opening. 

Grasp the upper corners of the SSC and insert the gold fingers of 
the edge connector into the slot in the back of the Apple, rear edge 
first. Gently push the front edge of the card down until it is 
level and firmly seated. Figure 3-2 shows how the SSC looks when 
installed in slot 112. 

Note that the outer ends of the screws in the clamp assembly can act 
as nuts. They are threaded and can receive screws from the printer 
or terminal connector, to ensure a good connection with the Apple. 
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Figure 3-2. SSC in Slot 92 and Clamp Assembly in Notch 



Slide the Apple case top plate in place and press down on the rear 
corners until the corner fasteners pop into place. The Super Serial 
Card is now installed. 

EXTERNAL CABLE AND CONNECTOR 

The SSC cable connector you installed in the notch is a standard 
DB-25 connector with 25 pins. Ten pins of the connector are 
connected internally to the SSC. 

You will need a cable to connect the modem or other device to the 
SSC connector on the Apple II. Cables with 25-pin connectors on one 
end are available from your Apple dealer. 

The cable must have internal shielding, with the shielding properly 
terminated at both ends, to prevent electromagnetic interference to 
nearby radios, television sets, and communication equipment. This 
shielding is necessary for the system to comply with Class B Federal 
Communications Commission limits as defined by Subpart J of Part 15 
of the FCC rules. Unshielded cables are not recommended. 



Make sure that all devices are connected to the same grounded 
AC power circuit (three-wire wall outlet) as the Apple II. 
Connecting ungrounded equipment to your Apple II can cause 
severe electrical damage. 



USING SSC IN COMMUNICATIONS MOPE 

Communications Mode allows you to use the SSC with a modem, connected 
to a remote device (such as a remote printer, terminal, or other 
computer). After installing the SSC, you can control its operation 
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from a BASIC, Pascal or assembly-language program, or even directly 
from the keyboard. To use the SSC in Communications Mode, do the 
following: 

• Make sure the jumper block points toward MODEM. 

• Under BASIC or DOS, boot the Apple II, and then type in PR#s 
and IN#s to route input and output, respectively, to and from 
the remote device. (The SSC is in slot s. ) 

• Under Pascal, boot the Apple II and then use #7: or REMIN: 
for input, and #8: or REMOUT: for output. (The SSC is in 
slot #2.) 

• If the modem and remote device don't work, refer to Appendix E 
for troubleshooting hints, or consult your Apple dealer. 



COMMUNICATIONS MODE COMMANDS 

You can issue any of the commands described in this section by 
embedding them in a computer program. Under BASIC or DOS, you can 
also enter them directly at the Apple (or remote terminal) keyboard. 

In a BASIC program, put the control character and command in a PRINT 
statement. In a Pascal program, embed the command in a WRITE or 
WRITELN statement. 

Before keyboard entry of these commands has any effect on the SSC, 
you must first issue an IN#s command (with the SSC in slot s). When 
you then enter the command character (usually <CTRL-A>, see below), 
the prompt APPLE SSC: appears on the display screen. Subsequent 
characters up to <RETURN> will be interpreted as an SSC command. 
Pressing the left arrow key before pressing <RETURN> cancels the 
command and causes the APPLE SSC: prompt to reappear. 

Many of these commands override the physical switch settings on the 
SSC. This makes it unnecessary to open the Apple II case and 
manually change the SSC switch settings. To change the values back 
to the physical switch settings, reboot or reset the Apple II, or 
type in the Reset command described below. 

COMMAND FORMATS 

All commands are preceded by the Comnuni cat ions Mode command 
character (usually <CTRL-A>, see below) and followed by <RETURN>. 
The notation <CTRL-A> means "hold down the CTRL key while 
pressing A." There are three types of command formats: 
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• a number <n> followed by an uppercase letter (for example, 
AD to set Data Format 4) 

• simply an uppercase letter (for example, R to Reset the SSC) 

• an uppercase letter followed by a space and then either E to 
Enable or D to Disable a feature (for example, L D to 
Disable automatic generation of linefeed characters) 

The allowable range of <n> is given in each command description 
below. The choice of Enable or Disable is written as <E/D>. 



The underscore character (_) before the <E/D> in Enable/Disable 
commands is merely a reminder that a space is required there. 

The SSC checks only numbers and the first letters of commands and 
options. All such letters must be uppercase. Further letters, 
which you can add to assist your memory, have no effect on the SSC. 
For example, E(cho E(nable is the same as E E. The SSC ignores 
invalid commands. 

THE COMMAND CHARACTER 

The normal command character in Communications Mode is <CTRL-A>. 
You can send the command character itself through the SSC by typing 
it twice in a row: <CTRL-AXCTRL-A> (no <RETURN> necessary). This 
special command allows you to transmit the command character without 
affecting the operation of the SSC, and without having to change to 
another command character and then back again later. 

If you want to change the command character from <CTRL-A> to 
<CTRL-some thing else>— for example, <CTRL-W>— type <CTRL-AXCTRL-W> . 
To change back, type <CTRL-WXCTRL-A>. No <RETURN> is required 
after either of these commands. 



Do not change the control character to <CTRL-S>, <CTRL-T> or 
<CTRL-R>, since in Communications Mode the SSC interprets these 
as special control commands from a remote device. 



=P 



3 
3 



=H 



The command character <CTRL-A> is ASCII code 1. 
generate this character in BASIC and Pascal: 



Here is how to 



Integer BASIC: 
Applesoft BASIC: 
Pascal: 



PRINT "*command" *embedded <CTRL-A> 
PRINT CHR$(2): "command" 
WRITELN (CHR(2), 'command'); 



ft 

ft! 



COMMUNICATIONS MODE COMMAND SUMMARY 

Table 3-4 is a summary of the commands available in Communications 
Mode. Some details, explained fully in the remainder of this 
chapter, have been omitted from the table for the sake of brevity. 
Commands marked with an asterisk are not supported by Pascal. 
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roriji 1 


• • .nnand Name 


Val ues 


Interpretation 




<n>B 


Baud Rate 


0-15 


see Table 3-5 




<n>C 


<CR> Delay 



1 
2 
3 


no delay 

32 mi lliseconds 

250 milliseconds (1/4 s) 

2 seconds 




<n>D 


Data Format 



1 
2 
3 
4 
5 
6 
7 


8 data bits, 1 stop bit 

7 data bits, 1 stop bit 

6 data bits, 1 stop bit 

5 data bits, 1 stop bit 

8 data bits, 2 stop bits 

7 data bits, 2 stop bits 

6 data bits, 2 stop bits 
5 data bits, 2 stop bits 




<n>F 


<FF> Delay 



1 
2 
3 


no delay (default) 

32 milliseconds 

250 milliseconds (1/4 s) 

2 seconds 




<n>L 


<LF> Delay 



1 
2 
3 


no delay (default) 

32 milliseconds 

250 milliseconds (1/4 s) 

2 seconds 




<n>P 


Parity 


0,2,4,6 


no parity (default = 0P) 








1 


odd parity 








3 


even parity 








5 


MARK (parity bit always 1) 








7 


SPACE (parity bit always 0) 




* <n>S 


Screen Slot 


0-7 


chain SSC output to slot n 




* <n>T 


Translate 





change all LC to UC 






Lowercase (LC) 


1 

2 
3 


leave LC (possible garbage) 
LC to UC inverse; leave UC 
LC to UC; UC to inverse 




B 


Break 




transmit 233 ms BREAK 




* R 


Reset the SSC 




SW reset + PR00 and IN#0 




* T 


Terminal Mode 




(see Terminal Mode section) 




7. 


Zap <CTRL> 




ignore all <CTRL> commands 




* E <E/D> 


Echo 


E or D 


echo input on the screen 




P <E/D> 


Find Keyboard 


E or D 


accept keyboard entries 




L <E/D> 


Generate <LF> Out 


E or D 


send <LF> out after <CR> 




M <E/D> 


Mask <LF> In 


E or D 


drop <LF> in after <CR> 




X <E/D> 


XOFF Recognition 


E or D 


detect XOFF; await XON 




* Not supported by Pascal. 









1 



Table 3-4. Summary of Communications Mode Commands 
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COMMANDS THAT CHANGE SWITCH SETTINGS 

The commands discussed in this section either override the SSC 
switch settings, or affect related behavior of the SSC. The Reset 
command restores the switch selections. 

Baud Rate-<n>B 

This command overrides the physical settings of switches SW1-1 to 
SW1-4 on the SSC. For example, to change the rate to 9600 baud, 
type <CTRL-A>14B<RETURN>. 






<n>= 


SSC Baud Rate 


<n>= 


SSC Baud Rate 





use SW1-1 to SW1-4 


8 


1200 


1 


50 


9 


1800 


2 


75 


10 


2400 


3 


109.92 (110) 


11 


3600 


4 


134.58 (135) 


12 


4800 


5 


150 


13 


7200 


6 


300 


14 


9600 


7 


600 


15 


19200 



Table 3-5. Baud Rate Selections 

Data Format-<n>D 

With this command you can override the settings of switches SW2-1 
and SW2-2. The table below shows how many data and stop bits 
correspond to each value of <n>. For example, typing <CTRL-A>3D 
<RETURN> causes the SSC to transmit each character in the form: one 
start bit (always transmitted), five data bits, and one stop bit. 

<n>= Data Bits Stop Bits 

8 1 

1 7 1 

2 6 1 

3 5 1 

4 8 2 (1 with <n>P options 4 through 7) 

5 7 2 

6 6 2 

7 5 2 (1-1/2 with <n>P options through 3) 



Table 3-6. Data Format Selections 

Parity-<n>P 

You can use this command to determine the kind of parity the SSC is 
to generate when sending data and check for when receiving data. 
There are five parity options available: 



3 
-J 

3 



3 
i 



J 



3 

A 



<n>* 



Parity to Use 



J, 2, 4 or 6 



none 

odd parity (odd number of l's) 
even parity (even number of l's) 
MARK parity (parity bit always 1) 
SPACE parity (parity bit always 0) 

Table 3-7. Parity Selections 



For example, type <CTRL-A>1P<RETURN> to cause the SSC to transmit 
and check for odd parity. Odd parity means that the high bit of 
every character is if there is already an odd number of 1 bits in 
that character, or 1 if there is otherwise an even number of 1 bits, 
making the total always odd. This is an easy (but not foolproof) 
way to check data for transmission errors. (See Appendix F.) 

Generate <LF> Out-L_<E/D> 

You can use this command to have the SSC automatically generate and 
transmit a linefeed (<LF>) character after each carriage return 
(<CR>) character. This overides the setting of switch SW2-5. For 
example, you can type <CTRL-A>L E<RETURN> to cause your printer to 
produce double-spaced listings or manuscripts for editing. 

Mask (Suppress) <LF> ln-M_<E/D> 

If you type <CTRL-A>M D<RETURN>, the SSC will not remove incoming 
linefeed (<LF>) characters that immediately follow carriage return 
(<CR>) characters. 

Reset the SSC-R 

Typing <CTRL-A>R<RETURN> has the same effect as sending a PR#0 and 
an IN#0 to a BASIC program and then resetting the SSC. This 
keyboard command cancels all previous commands to the SSC and puts 
the physical switch settings back into force. 

OTHER COMMANDS 

The commands described in this subsection control the handling of 
characters and of the video screen. Three commands control timed 
delays following transmission of <CR>, <LF> and <FF> characters. 
The Translate command controls the display of lowercase and 
uppercase characters. The Z and F commands suppress control 
characters and characters entered at the keyboard, respectively. 
The X command causes the SSC to check the character stream for XOFF, 
as part of the XON/XOFF protocol. Finally, the <n>S command routes 
video output to a selected slot, and the E command suppresses 
display (echo) of characters on the screen. 
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Set Time Delays-<n>C, <n>L, <n>F 

Some printers are slow and do not provide a "printer busy" or 
handshake signal to the Apple II. If such a printer is connected to 
the SSC via a modem, you may want to use these three delay commands. 

The <n>C command causes the Apple II to delay a specified amount of 
time, after sending a carriage return character, before sending 
another group (usually another line) to it. This gives the print 
head enough time to return to the left side of the page so it is 
ready to continue printing. 

The <n>L command allows time after a linefeed character for a 
printer platen to turn so the paper is vertically positioned to 
receive the next line. 

The <n>F command allows time after a form feed character for the 
printer platen to move the paper form to the top of the next page 
(typically a longer time than a Linefeed). 



<n>= 



Time Delay 



none 

32 milliseconds 

250 milliseconds (1/4 second) 

2 seconds 



Table 3-8. Time Delay Selections 



Consult the user manual for the printer to find out how much time it 
takes to move its print head and platen, and so to determine an 
appropriate set of values for these three delays if a printer is 
used as the remote device. The idea is to have at least enough time 
for the printer parts to move the required distance, but not so much 
time that overall printing speed is slowed down drastically. 

Translate Lowercase Characters-<n>T 

The Apple II monitor "translates" all incoming lowercase characters 
into uppercase ones before sending them to the video screen or to a 
BASIC program. With the <n>T command, four options are available: 
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<n>= 



What to Do with Lowercase Characters 



Change all lowercase characters to uppercase before passing 
them to a BASIC program or to the video screen. This is what 
the Apple II monitor does to lowercase. 

Pass along all lowercase characters unchanged. The 
appearance of the lowercase characters on the Apple II 
screen is undefined (garbage). 

Display lowercase characters as uppercase inverse characters 
(that is, as black characters on a white background). 

Pass lowercase characters to programs unchanged, but display 
lowercase as uppercase, and uppercase as inverse uppercase 
(that is, as black characters on a white background). 



Table 3-9. Lowercase Character Displays 

Zap (Suppress) Control Characters-Z 

Typing <CTRL-A>Z<RETURN> prevents the SSC from recognizing any 
further control characters (and hence commands) in the stream of 
characters moving through the SSC. 

If you issue the Z command, all further commands are ignored; this 
is useful if the data you are transmitting contains bit patterns 
that the SSC can mistake for control characters. 



The only way to reinstate command recognition after invoking 
the Z command is to reset the SSC, or clear the high-order bit 
at location $5F8+s (with the SSC in slot s). 



Find Keyboard-F_<E/D> 



You can protect incoming data from disruption by keystrokes with 
this command. For example, you can include <CTRL-A>F D in a 
program, followed by a routine that retrieves data coming in through 
the SSC, followed by <CTRL-A>F E later in the program. 



XOFF Recognition-X_<E/D> 



In Communications Mode, the SSC automatically recognizes any XOFF 
(decimal 19; Appendix D) character coming from a device attached to 
it, and responds to it by halting transmission of characters. The 
SSC resumes transmission as soon as it receives an XON character 
(decimal 17; Appendix D) from the device. To disable XOFF 
recognition, use <CTRL-A>X D<RETURN>. 
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Specify Screen Slot-<n>S 



With this command you can specify the slot number of the device 
where you want text or listings displayed. (Normally this is slot 
#0, the Apple II video screen.) This allows "chaining" of the SSC 
to another card slot, such as an 80-column-display peripheral card. 
For the firmware in the SSC to pass on information to the firmware 
in the other card, the other card must have an output entry point 
within its Cs00 space; this is the case for all currently available 
80-column-display cards for the Apple II. 

For example, let's say you have the SSC in slot #2 with a remote 
terminal connected to it, and an 80-column-display card in slot //3. 
Type <CTRL-A>3S<R£TURN> to cause the data from the remote terminal 
to be chained through the card in slot #3, so that it is displayed 
on the Apple II in 80-column format. (Not available in Pascal.) 

Echo Characters on the Screen-E_<E/D> 

For the Apple II, as for most computers, displaying ( echoing ) a 
character on the video screen is a separate step from receiving it 
from the keyboard, though we tend to think if these as one step, as 
on a typewriter. For example, if you type in <CTRL-A>E D<RETURN>, 
the SSC does not forward incoming characters to the Apple II screen. 
This can be used to hide someone's password entered at a terminal, 
or to avoid double-display of characters. 



TERMINAL MODE 

Under Communication Mode, the SSC can enter Terminal Mode and make 
the Apple II act like an unintelligent terminal. This is useful for 
connecting the Apple II to a computer timesharing service, or for 
conversing with another Apple II. 

Terminal Mode makes it possible to generate lowercase characters, 
plus the ten ASCII characters not provided on the Apple II keyboard 
(plus ESC, since <ESC> is used for this feature). 

To generate lowercase characters, press <ESC> (the "ESCAPE" key near 
the upper left corner of the Apple II keyboard) once, and then type 
alphabetic characters as you would normally do. After that, to 
capitalize a single letter, press <ESC> again before typing the 
letter. To lock the keyboard in uppercase, press <ESC> twice in 
succession. To get back to lowercase, press <KSC> once, as before. 

To generate one of the special ASCII characters listed in 
Table 3-10, first press <ESC> once (if necessary) to place the 
keyboard in lowercase mode. Then press <ESC> a second time, 
followed by one of the top-row keys as shown in Table 3-10. For 
example, to send a tilde, make sure the keyboard is in lowercase 
mode, then type <ESC> followed by 9. 
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-I 
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A 



<ESC> followed by: 


1 


2 


3 


4 


3 


6 


7 


8 


9 : 


generates : 


FS 


US 


I 


\ 





{ 


1 


> 


~ ESC RUB 


or in hexadecimal: 


9C 


9F 


DB 


DC 


DF 


FB 


FC 


FD 


FE 9B FF 



Table 3-10. Special ASCII Character Generation 

TERMINAL MODE COMMANDS 

The commands that specifically affect Terminal Mode are listed in 
Table 3-11. The Translate, Echo and XOFF commands are described 
earlier in this chapter. 



Format 



Command Name 



Interpretation 



T 
B 

* E_<E/D> 
S_<E/D> 

* <n>T 

* X <E/D> 



Enter Terminal Mode 

Transmit a Break 
Signal 

Echo Enable/Disable 



Special Characters 
Enable/Disable 



Translate Lowercase 
Characters 

XOFF Recognition 
Enable/Disable 



Quit (Exit from) 
Terminal Mode 



Go into Terminal Mode. 

Send a 233-millisecond BREAK 
(signoff) signal. 

Default E D (full-duplex); use E E 
for half-duplex. 

Default S E; allows/defeats 
generation of lowercase and 
special characters (Table 3-10). 

Determine treatment of incoming 
lowercase characters. 

Default X E; in Terminal Mode, X E 
makes SSC detect <CTRL-R> and 
<CTRL-T> (remote-control OFF & ON, 
respectively), but not <CTRL-S>. 

Return to normal Communications 
Mode operation. 



* Fully described earlier in this chapter. 



1 



Table 3-11. Terminal Mode Commands 



Enter Terminal Mode-T 

This causes the Apple II to function as a full-duplex unintelligent 
terminal. You can use this command in conjunction with the ECHO 
command to simulate the half-duplex terminal mode of the old Apple 
II Communications Card. Type <CTRL-A>T<RETURN> to enter this mode. 



If you enter Terminal Mode and don't see what you type echoed 
on the Apple video screen, probably the modem link has not yet 
been established, or you need to use the E(cho E(nable command. 
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Transmit a Break Signal-B 



Typing <CTRL-A>B<RETURN> causes Che SSC to transmit a 
233-millisecond break signal, recognized by most time-sharing 
systems as a signoff. 

Special Characters-S_<E/D> 

Typing <CTRL-A>S E<RETURN> causes the SSC to interpret <ESCXn> 
pairs as special characters, allowing a keyboard in this way to 
generate all possible ASCII characters. If you type <CTRL-A>S 
D<RETURN>, the SSC will treat the <ESC> key like any other key. 

Quit (Exit from) Terminal Mode-Q 

Type <CTRL-A>Q<RETURN> to exit from terminal mode. 

A TERMINAL MODE EXAMPLE 

You can use the sample program below to change the SSC temporarily 
from the characteristics you ordinarily use, to the characteristics 
needed to make the Apple II into a dumb terminal connected to the 
Dow Jones News & Quotes Reporter. This program assumes that the SSC 
is set for Communications Mode and that the jumper block is pointing 
toward MODEM. Neither of these conditions can be changed by 
software. This program also assumes that the SSC is in slot #1 and 
that you want to chain I/O to an 80-colunn card in slot #3; these 
conditions you can change via software. To change this Integer 
BASIC program to an Applesoft program, substitute CHR$(5) for D$ and 
CHR$(2) for AS, and leave out program lines 40 and 42. 

10 REM ***************************************************** 

20 REM * THIS PROGRAM SETS UP THE SSC FOR DOW JONES * 

30 REM ***************************************************** 

40 D$="": REM TYPE <CTRL-D> ESCAPE CHARACTER BETWEEN QUOTES 

42 AS="" : REM TYPE <CTRL-A> COMMAND CHARACTER BETWEEN QUOTES 

50 PRINT D$;"PR#1": REM SSC IS IN SLOT #1; 

52 PRINT A$;"6 BAUD": REM SET BAUD RATE TO 300; 

54 PRINT A$;"l DATA": REM DATA FORMAT OF 7 DATA, 1 STOP 

56 PRINT A$;"0 PARITY": REM AND NO PARITY; 

58 PRINT A$;"LF DISABLE": REM NO <LF> GENERATION AFTER <CR>. 

60 PRINT A$;"3 SLOTCHN" : REM CHAIN TO CARD IN SLOT #3 

62 PRINT A$;"TERM MODE": REM AND ENTER TERMINAL MODE. 

70 REM ***************************************************** 

72 REM * NOW YOU SHOULD BE IN TERMINAL MODE, CETTING THE * 

74 REM * INFO YOU NEED FROM THE DOW JONES SERVICE. WHEN * 

76 REM * FINISHED, EXIT WITH THE <CTRL-A>Q(UIT COMMAND. * 

78 REM ***************************************************** 

100 REM Q(UIT COMMAND SENDS CONTROL BACK TO THIS PROGRAM: 
110 PRINT A$; "RESET": REM RESET SWITCH-SELECTED OPTIONS 

120 END 
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CHAPTER 4 

HOW THE SCC WORKS 



This chapter Is divided into three major sections. The first 
explains what the SSC does, using everyday terms wherever possible. 
Those of you already familiar with serial data communication can 
skip this section. 

The second section is for anyone who wants an overview of the SSC's 
operating modes and configuration possibilities. 

The third section is a dyed-in-the-wool hardware theory of operation 
for both the expert and the adventuresome layperson. 



SERIAL DATA COMMUNICATION 

The SSC is a device that performs serial data communication. Let's 
consider communication first, then data , and then serial data and 
data transfer. 

Communication is easy enough: getting information from here to 
there or from there to here. In this discussion, the Apple II is 
"here." "There" can be nearby ( local ) or far enough away ( remote ) 
that some intermediate device, like a telephone, is needed. 
Information moving from here to there (out of the Apple) is called 
output ; information moving from there to here (into the Apple) is 
called input . 

Data denotes information in its many forms. For successful data 
communication, it is essential that both the sender and receiver 
agree on their interpretation of the data transferred. 

Inside the Apple II, data can be numbers and letters and symbols, or 
program instructions for the computer to carry out, or pointers to 
storage locations, or error message numbers, or codes for generating 
pictures or sounds (or lots of other things). 

In the Apple II, as in all other computers, data is represented in 
codes made up of ones and zeros, the only two digits allowed in the 
binary (two-element) system. Each one or zero is called a Binary 
digiT or bit . In the binary system, as in our ordinary decimal 
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system, you can count to as high a number as you want — It just takes 
more digits to get there than in the decimal system — and use each 
number as a code to represent that number of different items. Table 
4-1 gives some examples of how many items you can represent with 
various quantities of digits. 

System Digits Using You can represent 



decimal 0-9 



binary and 1 



1 ten items (0 through 9) 

2 one hundred (0 through 99) 

3 one thousand (0 through 999) 

1 two items (0 or 1 ) 

2 four (0, 1, 10 or 11) 

3 eight (0 through 111) 

4 sixteen (0 through 1111) 

5 thirty-two (0 through 11111) 

6 sixty-four (0 through 111111) 

7 one hundred twenty-eight 

8 two hundred fifty-six, etc. 



Table 4-1. Binary and Decimal Digits and Quantities 



For printers, plotters, terminals, and many other devices, 128 codes 
are enough to distinguish all the necessary characters : 52 for the 
upper and lowercase alphabet, 10 for the decimal digits, and dozens 
of others for punctuation marks and special symbols. As a result, 
the 128-character American Standard Code for Information Interchange 
(ASCII) is widely used. (This 7-bit code is listed in Appendix D.) 

Throughout the world, post, telegraph, telex and wire services 
use 5-bit and 6-bit code sets, even though so few bits cannot 
represent a very large selection of items. Meanwhile, computers 
have a penchant for sending each other streams of 8-bit codes with 
obscure meanings. As long as sender and receiver agree on 
interpretation, any set of codes will do. The SSC can send all of 
them. 

PARALLEL DATA IN THE APPLE II 

The Apple II is called an eight-bit processor because the basic 
unit of data it uses and moves around internally is an eight-bit 
byte . The Apple II has sets of eight lines interconnecting its 
various internal parts, so it can move around all eight bits at the 
same time. Since the bits travel together like eight cars side by 
side on an eight-lane highway, data in the Apple II is called 
parallel data, and data movements within the Apple II are called 
parallel data transfers (Figure 4-1). 
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Figure 4-1. Parallel Data Transfer 



SERIAL DATA FOR LONG DISTANCES 

Just as it would be extremely costly to build highways with eight 
lanes in each direction over great distances, so it is costly to 
connect two widely separated pieces of equipment using eight lines 
in each direction. So, many manufacturers produce computers, 
printers, plotters, terminals and so forth that send and receive 
information along one line in each direction, one bit after another. 
Such a setup, with bits moving from one place to another like a 
string of cars in a single lane, is called a serial data transfer 
(Figure 4-2). 



letter R = 11010010 = $D2 
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Figure 4-2. Serial Data Transfer 



DATA CONVERSION 

Changing parallel data to serial data or vice versa is called data 
conversion (Figure 4-3). By convention (see the later subsection 
describing RS-232-C), whenever parallel data is converted to serial 
data, the right-hand bit is sent first. It is as though there were 
a traffic law that when a multi-lane highway narrows to a single 
lane, the car in the right lane goes first, then the car from the 
next lane to the left, etc. 
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-~ISB) I 



letter A = 11000001 = SC1 
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Figure 4-3. Parallel-to-Serial Data Conversion 
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RS-232-C DATA FORMATS 

Serial data communication became popular so quickly that a group 
of manufacturers and the telephone company formed the Electronic 
Industries Association (EIA) to agree upon standard ways of sending 
and receiving data. What has become the most widely used standard 
in the world is called Revision C of standard RS-232, or RS-232-C . 
The SSC sends and receives data in accordance with this standard. 
The serial data has the form shown in Figure 4-3, plus a start bit 
at the beginning, an optional parity bit after the five to eight 
data bits, and finally one or two stop bits at the end (Figure 4-4). 
This is the data format that most RS-232-C devices use. 
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Figure 4-4. RS-232-C Serial Data Format 



What is this mysterious parity bit all about? It is an optional 
extra bit set to or 1 to make the total number of data and stop 
bits set to 1 an odd number (odd parity) or an even number (even 
parity); or this extra bit can always be set to (called SPACE 
parity) or to 1 (MARK parity). 

The combined total of data and parity bits set to 1 in Figure 4-4 is 
5, an odd number (and the parity bit is 1), so it qualifies as a 
correct character if odd parity (or MARK parity) has been agreed 
upon by sender and receiver. However, if that same character were 
received under even parity (or SPACE parity), the receiving device 
would signal that a transmission error had occurred. If one bit in 
a character changes during transmission, parity checking will detect 
the error. If two bits change, the error will go undetected. 



RS-232-C SIGNALS 

Since the RS-232-C standard stems 
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RS-232-C Signal 



Abbrev. Similar to 



Data Terminal Ready DTR 

Data Set Ready DSR 

Request To Send RTS 

Clear To Send CTS 



Transmit Data TxD 

not Request To Send RTS 



not Clear To Send 



CTS 



not Data Terminal Rdy DTR 



you pick up the phone 
the phone is working 
you want to talk 
the phone has established a 
connection and the person at the 
other end is ready to listen 
you speak into the phone 
you've finished talking and are 
ready to listen or to hang up 
the phone has sent your words and 
is ready for your next request to 
send a message 
you hang up 



Table 4-2. RS-232-C Signals As Interpreted by the Sender 



Here are the RS-232-C signals and how you would interpret them 
if you were to answer a telephone call (Table 4-3). 



RS-232-C Signal Abbrev. Similar to 



Ring Indicator RI 

Data Set Ready DSR 

Data Carrier Detect DCD 

Receive Data RxD 

not Data Set Ready DSR 



the phone rings (optional) 

you pick up the phone; it works 

you hear background noise 

you hear what is said 

the other party has hung up 



Table 4-3. RS-232-C Signals As Interpreted by the Receiver 

Modems 

All of the above signals refer to the interaction between what 
RS-232-C calls Data Terminal Equipment (DTE — end points of data 
transfers, such as the Apple II or a printer) and what It calls Data 
Communication Equipment (DCE — transmitting or receiving devices, 
such as modems). 

What is a modem ? The name is short for MOdulator/DEModulator. As a 
modulator it takes electrical signals from a computer or printer (or 
other device) that It Is connected to, and turns then Into musical 
tones over a telephone line. As a demodulator it takes the musical 
tones it detects on a telephone line and turns them back into 
electrical signals for use by the printer or computer (or other 
device) that it is connected to. It also handles the RS-232-C 
control signals to and from that device (Figure 4-5). 
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Figure 4-5. An RS-232-C Setup with Modems 



By convention, the calling ( originate ) modem produces a fairly high 
tone (let's say LA) as the background or carrier signal that it 
sends; it then modulates (changes) that tone to SO to mean and 
TI to mean 1. Meanwhile, the called ( answer ) modem plays a lower 
tone, MI, as a carrier signal, and modulates that tone to RE to 
indicate or FA to indicate 1. In this way, both modems can send 
and receive information along the same wires without interpreting 
what they send as received messages and vice versa. (All their 
voices sound alike.) 

Modem Eliminators 

RS-232 signals are designed for the interactions of two DTE's, two 
DCE's, and telephone lines, as shown in Figure 4-5. What if you 
just want to connect two DTE's together in the same room, directly 
(for example, an Apple II and a printer)? You can use what is 
called a null modem or modem eliminator . The jumper block on the 
SSC does just that when it is connected with its triangle pointing 
toward the word TERMINAL. 

By using different tones to send and receive information, modems 
can make sure that what comes from the "mouthpiece" ( transmit 
register ) of one DTE gets routed to the "earpiece" ( receive 
register ) of the other. A null modem simply crosses those two 
wires (Figure 4-6). 

To simulate the other signal exchanges that modems would perform, 
the null modem interconnects the signal wires as shown in 
Figure 4-6. Thus RTS gets turned back to the sender as CTS as 
though the phone had instantly established a connection; RTS is also 
connected to DCD on the other side to pretend that a carrier signal 
has been detected. Finally, connecting DTR (willing to transfer 
data) from one side to both RI and DSR (a call arriving) on the 
other side completes the simulated telephone connection. (RI is 
optional.) The jumper block does it all! 
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Figure 4-6. An RS-232-C Setup with a Modem Eliminator 



SSC MODES AND CONFIGURATIONS 

Figure 4-7 outlines the possible operating modes of the Super Serial 
Card and their relationships to each other. 
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Figure 4-7. SSC Operating Modes 
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Figure 4-8 illustrates the chief configurations possible with the 
Super Serial Card and how to set them up. 
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Figure 4-8. SSC Configurations 
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THEORY OF OPERATION 



This section explains the SSC's overall theory of operation, but not 
the internal workings of each TC chip. If you would like such 
information, it is best to obtain specifications from the IC 
manufacturers. The most complex component is the ACIA, which is a 
Synertek 6551 or equivalent. 

While reading through this section, you may find it useful to refer 
to Figure 4-9, a block diagram of the SSC, or to the schematic 
diagram in Appendix C. All references in the form 1A, 3C, etc., 
pertain to coordinates on the printed circuit board itself. Here is 
an inventory of the main components of the SSC: 

• 50-pin connection to the Apple II peripheral connector slot 

• a 12-line address bus 

• addressing and control logic (IB, IC, 2C, 3C) 

• a 2K-by-8-bit ROM (4B-5C) 

• jumpers and bow ties for optional substitution of RAM (3-4A) 

• two blocks of 7 switches each (1A, 2A) 

• two registers for reading the switch settings (2B, 3B) 

• an Asynchronous Communications Interface Adapter 
(ACIA; 4-5A) with Its Internal registers: 

status/reset register control register 

transmit/receive data register command register 

• a 1.8432 MHz oscillator (3A) for the ACIA 

• a transmit Interface (6A) and a receive Interface (7A) 

• an 8-line data bus 

• a buffer for the data bus (6C) 

• a jumper block (6B) that can function as a modem eliminator 

• a 10-pln header (7B) to connect the SSC to a DB-25 jack 
via a short internal cable (discussed in Appendix C) 
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Figure 4-9. Overall Block Diagram of the SSC 
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ADDRESSING AND CONTROL LOGIC 

The twelve address lines (A0 - All) from the Apple II provide all 
the necessary $C000 addressing on the SSC. Control logic at IB, 1C 
2C and 3C, plus the signals RESET, DEVICE SELECT, I/O SELECT, and 
I/O STROBE, ensure the routing of signals to the appropriate 
addresses. 

The SSC follows the Apple II protocol in its use of the $C800 
address space. An LS279 (IB) serves as a NAND gate, a pair of 
inverters, and a set-reset latch. The latch is set by an access to 
the $Csxx space, and is reset by access to the $CFxx space or by a 
reset. When this set-reset latch is set, the Apple II can access 
the $C800 space on the SSC. A small RC filter prevents the latch 
from being reset by spurious noise. 

ROM/RAM Space 

The 2K ROM (4B-5C) containing the SSC driver firmware resides in the 
$C800 - $CFFF address space. However, an LS00 (2C) and an LS32 (3C) 
remap the addresses from the range $Cs00 - $CsFF to the range 
SCF00 - $CFFF, since the $CFxx addresses are unusable. (Access to 
them disables use of the $C800 address space.) As a result of this 
remapping, only one ROM is required, and none of the ROM space is 
wasted. 

The SSC can use a 2K-by-8-bit RAM in place of the ROM. Between 
columns 3 and 4 and rows A and B on the SSC, there are three jumper 
pads and three bow ties. If you solder the jumper pads and cut the 
bow ties, pins 18, 20 and 21 will be, respectively, chip enable, 
output enable and read-write control (instead of ROM enables). 

The ROM (or RAH) addresses are mapped as follows (Table 4-4). The 
first 256-byte block is the Peripheral Card ROM Space, selected when 
I/O SELECT from the Apple II drops to volts. The remaining seven 
blocks are in the I/O Expansion ROM Space, selected when I/O STROBE 
from the Apple II drops to volts. 



SSC ROM /RAH Addresses 

$0700 - $07FF 

50000 - S00FF 

$0100 - $01FF 

$0200 - $02FF 

$0300 - $03FF 

$0400 - $04FF 

$0500 - $05FF 

$0600 - $06FF 



Become Apple II Addresses 

$Cb00 - $CsFF 
$C800 - $C8FF 
$C900 - $C9FF 
$CA00 - $CAFF 
$CB00 - $CBFF 
$CC00 - $CCFF 
$CD00 - $CDFF 
$CE00 - $CEFF 



Table 4-4. SSC Address Remapping 
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Registers in Peripheral I/O Space 

Whenever DEVICE SELECT drops to volts, the Apple II is addressing 
the SSC's Peripheral I/O Space (the sixteen bytes starting at 
$C080 + s0). This signal is combined logically with address lines 
A0 through A3 to select one of the six registers that reside in that 
space (Table 4-5). 

Chip selected Address(+s 0) Purpose of register 

LS365 (2B) $C081 store state of SW1 (1A) (read) 

LS365 (3B) $C082 store state of SW2 (2A) and 

state of CTS (read) 

ACIA (4-5A) $C088 receive (read), transmit (write) 

ACIA (4-5A) $C089 status (read), reset (write) 

ACIA (4-5A) $C08A command (read and write) 

ACIA (4-5A) $C08B control (read and write) 



Table 4-5. Registers in SSC Peripheral I/O Space 



The two LS365 chips act as buffers so that the state of eleven of 
the fourteen available switches, plus the state of RS-232-C signal 
Clear To Send (CTS), can be read. There are 3.3K ohm pullup 
resistors at the switch inputs of the LS365 chips. A closed switch 
pulls down an input, and it is read as zero. 

Three switches are not connected to the LS365s. Switch SW2-6, when 
OH, passes interrupt requests from the ACIA to the Apple II. (The 
Apple II, however, currently does not support interrupts.) Setting 
switches SW1-7 ON and SW2-7 OFF connects DB-25 pin 8 (DCD) to the 
DCD input of the ACIA. Setting SW1-7 OFF and SW2-7 ON splices pin 
19, Secondary Clear To Send (SCTS) , onto the DCD input of the ACIA 
when the jumper block is in the TERMINAL position. 

The ACIA has two pins used to select one of its four registers. 
While address lines A2 and A3 select the chip, A0 and Al select the 
actual register. The SSC firmware reads and writes ACIA register 
contents; these registers are discussed in detail in Appendix A. 

THE ACIA 

The Asynchronous Communications Interface Adapter (ACIA) is the 
central and most complex element of the SSC. It and the crystal at 
3A form a 1.8432 !IHz oscillator. The ACIA divides this frequency 
down to one of the fifteen baud rates it supports. The ACIA also 
handles all incoming and outgoing primary RS-232-C signals. The 
ACIA registers (discussed fully in Appendix A) control hardware 
handshaking and select the baud rate, data format and parity. 
Finally, the ACIA performs parallel/serial and serial/parallel data 
rsion, and single-buffers data transfers. 
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DATA INPUT AND OUTPUT 

The MC1489 at 7A converts the incoming serial data from RS-232-C to 
TTL voltage levels. The MC1488 at 6A converts the outgoing serial 
data from TTL to RS-232-C voltage levels, and in conjunction with 
three capacitors limits the output slew rate. Three of the received 
handshake lines (Clear To Send, Data Carrier Detect, and Data Set 
Ready) have 15K ohm pullup resistors so the SSC will work with 
devices that do not assert those signals. 

DATA BUS 

The 8-bit data bus on the SSC is, of course, a parallel bus. The 
ACIA takes output from it and gives input to it in parallel form. 
Also connected to the bus are the two switch detection registers 
(2B and 3B) and the ROM or RAM chip. 

An LS245 (6C) buffers the output to the data bus, and minimizes 
input loading. The data bus has a 3.3K ohm pullup resistor on each 
line so the data inputs on the LS245 are not floating when it turns 
on in output mode. 

JUMPER BLOCK 

The jumper block has two positions: when its arrow points toward 
MODEM, the SSC looks like Data Terminal Equipment (DTE); that is, 
the SSC is prepared to talk to Data Communication Equipment (DCE) , 
such as a modem. When Installed with its arrow pointing toward 
TERMINAL, the jumper block acts as a modem eliminator (null modem); 
that is, the SSC looks like the DCE on the other device's side of a 
serial communication connection. In this position, the SSC can talk 
directly to a printer or any other DTE. Figure 4-6 shows the signal 
swapping that the jumper block in the TERMINAL position performs. 
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APPENDIX A 

FIRMWARE 



This appendix contains the following information: 

• an explanation of the Pascal 1.1 firmware card protocol 

• a firmware memory map 

• a description of the SSC's use of its peripheral slot 
scratchpad RAM addresses 

• a description of the ACIA registers and switch detection 
registers in the SSC's peripheral I/O space 

• a list of firmware entry points and 6502 register values 

• the actual SSC firmware listings 

PASCAL 1.1 FIRMWARE PROTOCOL 

The old Apple II Serial Interface Card (SIC) ran under Pascal 1.0 
with three direct firmware entry points, one for each of the three 
I/O functions it supported: 



Address 



Contains 



$C800 initialization routine entry point 

$C84D read routine entry point 

SC9AA write routine entry point 



New peripheral cards can be "accepted" into the Pascal 1.0 system by 
appearing to be a SIC; that is, with these same three entry points 
and with $38 at $Cs05 and $18 at $Cs07 (see Device ID section below). 

Pascal 1.1, on the other hand, has a more flexible setup, and also 
supports more I/O functions. It can make indirect calls to the 
firmware in a (new) peripheral card through addresses in a branch 
table in the card's firmware. It also has facilities for uniquely 
identifying new peripheral I/O devices. 
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I/O ROUTINE ENTRY POINTS 

The I/O routine entry point branch table is located near the 
beginning of the Cs00 address space (s being the slot number where 
the peripheral card is installed). This space was chosen instead of 
the $C800 space, since under BASIC protocol the $Cs00 space is required 
while the $C800 space is optional. 



The branch table locations that Pascal 1.1 uses are: 



Address 



Contains 



~l 



$Cs0D initialization routine offset (required) 

$Cs0E read routine offset (required) 

#Cs0F write routine offset (required) 

$Csl0 status routine offset (required) 

$Csll $00 if optional offsets follow; non-zero if not 

$Csl2 control routine offset (optional) 

$Csl3 interrupt handling routine offset (optional) 

Notice that $Csll contains $00 only if the control and interrupt 
handling routines are supported by the firmware. (For example, the 
SSC does not support these two routines, and so location $Csll 
contains a (non-zero) firmware instruction.) Apple II Pascal 1.0 and 
1.1 do not support control and interrupt requests, but such requests 
may be implemented In future versions of the Pascal BIOS and other 
future Apple II operating systems. 

Here are the entry point addresses, and the contents of the 6502 
registers on entry to and on exit from Pascal l.l I/O routines: 



Addr. 


Offset for 


X Register 


Y RuRistcr 


A Hi:;;is[rr 


$Cs0D 


Initialization 










On entry 


$Cs 


$s0 






On exit 


error code 


(unchanged) 


(unchanged) 


$Cs0E 


Read 










On entry 


SCs 


$s0 






On exit 


error code 


(unchanged) 


character read 


$Cs0F 


Write 










On entry 


$Cs 


$s0 


char, to write 




On exit 


error code 


(unchanged) 


(unchanged) 



$Csl0 Status 

On entry $Cs $s0 request (0 or 1) 

On exit error code (changed) (unchanged) 

Notes: Request code means, "Are you ready to accept output?" 
Request code 1 means, "Do you have input ready?" 
On exit, the reply to the status request Is in the carry 
bit: carry clear means "No"; carry set means "Yes." 



Table A-l . I/O Routine Offsets and Registers under Pascal 1.1 
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DEVICE IDENTIFICATION 

Pascal 1.1 uses four firmware bytes to identify the peripheral card. 
Both the identifying bytes and the branch table are near the 
beginning of the $Cs00 ROM space. The identifiers are listed in 
Table A-2. 



Address 



Value 



$Cs05 $38 (like the old Serial Interface Card) 

$Cs07 $18 (like the old Serial Interface Card) 

$Cs0B $01 (the Generic Signature of new FW cards) 

$Cs0C $ci (the Device Signature; see below) 



Table A-2. Bytes Used for Device Identification 



The first digit, c, of the Device Signature byte identifies the device 
class as listed in Table A-3. 



Digit Class 



$0 
$1 
$2 
$3 
$4 
$5 
$6 
$7 
$8 
$9 
$A 
$B-F 



reserved 

printer 

joystick or other X-Y input device 

serial or parallel I/O card 

modem 

sound or speech device 

clock 

mass storage device 

80-column card 

network or bus interface 

special purpose (none of the above) 

reserved for future expansion 



Table A-3. Device Class Digit 



The second digit, 1, of the Device Signature byte is a unique 
identifier for the card, assigned by Apple Technical Support. For 
example, the SSC has a Device Signature of $31: the 3 signifies 
that it Is a serial or parallel I/O card, and the 1 is the low-order 
digit supplied by Apple Technical Support. 

Although version 1.1 of Pascal ignores the Device Signature, 
applications programs can use thera to Identify specific devices. 
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SSC FIRMWARE MEMORY USAGE 

Table A-4 is an overall map of the locations that the SSC uses, both 
in the Apple II and in the SSC's own firmware address space. 



Addresses 



Name of area 



Contents 



$0000-$00FF Page Zero 



$04xx-$07xx 

(selected 

locations) 

$C0(8+s)0 - 
$C0(8+s)F 

$Cs00-$CsFF 



Peripheral Slot 
Scratchpad RAM 



Peripheral Card 
I/O Space 

Peripheral Card 
ROM Space 



$C800-$CFFF Expansion ROM 



Monitor pointers, I/O hooks, and 
temporary storage (Table A-5) 

Locations (8 per slot) in Apple's 
pages $04 through $07. SSC uses 
all eight of them (Table A-6) 

Locations (16 per slot) for general 
I/O; SSC uses 6 bytes (Table A-7) 

One 256-byte page reserved for card 
in slot s; first page of SSC FW 

Eight 256-byte pages reserved for 
a 2K ROM or PROM; SSC maps its FW 
onto $C800-$CEFF (Table 4-4) 



Table A-4. Memory Usage Hap 



ZERO PAGE LOCATIONS 

The SSC makes use of these zero-page locations (Table A-5): 



Address 



Name 



Desert pti on 



$24 



CH 



$26 


SL0T16 


$27 


CHARACTER 


$28 


BASL 


$2A 


ZPTMP1 


$2B 


ZPTMP2 


$35 


ZPTEMP 


$36 


CSWL 


$37 


CSWH 


$38 


KSWL 


$39 


KSWH 


$4E 


RNDL 



Monitor pointer to current position 

of cursor on screen 

Usually (slot* x 16); that is, $s0 

Input or output character 

Monitor pointer to current screen line 

Temporary storage (various uses) 

Temporary storage (various uses) 

Temporary storage (various uses) 

BASIC output hook (not for Pascal) 

(high byte of CSW) 

BASIC input hook (not for Pascal) 

(high byte of KSW) 

random number location, updated when 

looking for a keypress (not used when 

initialized by Pascal) 



* Not used when Pascal initializes SSC. 



Table A-5. Zero-Page Locations Used by SSC 



3 



SCRATCHPAD RAM LOCATIONS 

The SSC uses the Scratchpad RAM locations as listed in Table A-6. 
Address Field name Bit(s) Interpretation 



$0478+3 DELAYFLG - 1 

2-3 
4 - 5 
6-7 



$04F8+s HANDSHKE 
PARAMETER 

$0578+s STATEFLC 



$05F8+s CMDBYTE 

$0678+6 STSBYTE 
$06F8+s CHNBYTE 

PWDBYTE 
$0778+s BUFBYTE 

COLBYTE 
$07F8+s MISCFLG 



<FF> delay selection 
<LF> delay selection 
<CR> delay selection 
Translate option 



0-7 Buffer count for handshake (P8A Mode) 
0-7 Accumulator for FU's command processor 

0-2 Command mode when not (Printer and 

Communications "lodes only) 
0-4 Enquire character (P8A Mode); dflt ETX 
3-5 Slot to chain to (Communications Mode) 

6 Set to 1 after lowercase input character 

7 Terminal Mode when 1 (Coram Mode) 

7 Enable <CR> gen. when 1 (other 3 modes) 

0-6 Printer Mode default is <CTRL-I>; 
Coram Mode default is <CTRL-A> 
7 Set to 1 to Zap control commands 

Status and IORESULT byte (Appendix F) 

0-2 Current Apple screen slot (Comm Mode); 

when slot = 0, chaining is enabled 
3-7 $Cs00 space entry point (Comm Mode) 
0-7 Current printer width (other modes); 

for listing compensation, auto-<CR> 

0-6 One-byte input buffer (Comm Mode); used 
in conjunction with XOFF recognition 
7 Set to 1 when buffer full (Comm Mode) 

0-7 Current-column counter for tabbing, 
etc. (other 3 modes) 

Generate <LF> after <CR> when 1 

1 Printer Mode when 0; Comm Mode when 1 

2 Keyboard Input enabled when 1 

3 <CTRL-S> (XOFF), <CTRL-R> and <CTRL-T> 
input checking when 1 

4 Pascal Op Sys when 1 ; BASIC when 

5 Discard <LF> input when 1 

6 Enable lowercase and special character 
generation when 1 (Comra Mode) 

6 Tabbing option on when 1 (Printer Mode) 

7 Echo output to Apple screen when 1 



Table A-6. Scratchpad RAM Locations Used by SSC 
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£ * 
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PERIPHERAL CARD I/O SPACE 

There are 16 bytes of I/O space allocated to each slot In the 
Apple II. Each set begins at address $C080 + (slot x 16); for 
example, if the SSC is in slot 3, its group of bytes extends from 
$C0B0 to SC0BF. Table A-7 interprets the 6 bytes the SSC uses. 

Idress Register Bit(s) Interpretation 



SC0R1+S0 

SC082+S0 

$C088+s0 
$C089+s0 



D1PSW1 
(SWl-x) 

DIPSW2 
(SW2-x) 



TDREG 
RDREG 

STATUS 



$C08A+s0 COHIIANI) 



$C08B+s0 CONTROL 



4-7 



- 7 
- 7 






2-3 



5-7 



- 3 



5-6 



SW1-6 is OFF when 1, ON when 
SW1-5 is OFF when 1 , ON when 
same as above for SW1-4 through SW1-1 



Clear To Send (CTS) is true (-) when Q 

1 - 3 same as above for SW2-5 through SW2-3 
5 & 7 same as above for SW2-2 & SW2-1 



ACIA Transnit Register (write) 
ACIA Receive Register (read) 

ACIA Status/Reset Register 
Parity error detected when 1 
Framing error detected when 1 
Overrun detected when 1 
ACIA Receive Register full when 1 
ACIA Transmit Register empty when 1 
Data Carrier Detect (DCD) true when 
Data Set Ready (DSR) true when 
Interrupt (IRQ) has occurred when 1 

ACIA Command Register (read/write) 
Data Terminal Ready (DTR) : enable (1) or 
disable (0) receiver and all interrupts 
When 1, allow STATUS bit 3 to cause IRQ 
Control transmit interrupt, Request To 
Send (RTS) level, and transmitter 
When 0, normal mode for receiver; when 1, 
echo node (but bits 2 and 3 must be 0) 
Control parity (values: Table 2-7) 

ACIA Control Register (read/write) 

Baud rate: $0 = 16 times external clock; 

$1 - $F = decimal in Table 2-5 

When 1 , use baud rate generator; when 0, 

use external clock (not supported) 

Number of data bits: 8 (bit 5 and 6 = 0) 

7 (5 = 1, 6 = 0), 6 (5 = 0, 6 = 1) or 5 

(bit 5 and 6 both - 1) 

Number of stop bits: 1 (bit 7 = 0); if 

bit 7=1, then 1-1/2 (with 5 data bits, 

no parity), 1 (8 data plus parity) or 2 



Table A-7. SSC Registers in Peripheral Card I/O Space 



*i 



2* 

H 
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SSC ENTRY POINTS 



This section contains the SSC firmware entry points for the Apple II 
Monitor, BASIC, Pascal 1.0 and Pascal 1.1. The Pascal 1.1 entry 
point offsets conform to the Firmware card protocol outlined in the 
first section of this appendix. 

MONITOR ROM ENTRY POINTS 

The SSC uses these entry points in the Monitor ROM, unless Pascal 
initializes the SSC. 



Address 



Name 



Description 



$FDED COUT sends a character to output hook (chaining) 

used for chaining 
$FE89 SETKBD sets KSW to point to keyboard (reset) 

$FE93 SETSCR sets CSW to point to Apple screen (reset) 

SFF58 IORTS known position of an RTS instruction 

$FDF6 VIDOUT sends a character to the Apple screen 



Table A-8. Monitor ROM Entry Points Used by SSC 



BASIC ENTRY POINTS 

Here are the entry point addresses, and the contents of the 6502 
registers on entry to and on exit from BASIC I/O routines: 



Addr. Routine 



X Register Y Register A Register 



$Cs00 Initialization 

On entry anything anything anything 

On exit (unchanged) (unchanged) character 

Notes: CSW and/or KSW points to $Cs00. The character in the A 

register is output unless KSW points to $Cs00 and CSW does 
not point to $Cs00. 



$Cs05 Input 

On entry anything anything 

On exit (unchanged) (unchanged) 

Notes: Character in is from ACIA or keyboard. 

$Cs07 



anything 
character in 



Output 

On entry anything anything character out 

On exit (unchanged) (unchanged) (changed) 

Notes: Character out is transmitted through the ACIA. 



Table A-9. BASIC Entry Points Used by SSC 
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PASCAL I.O ENTRY POINTS 

There are three Pascal 1.0 entry points: one for Initialization, 
for read operations, and one for write operations. These entry 
points are direct addresses. 



Addr. Routine 



X Register 



Y Register A Register 



$C800 



Notes : 



$C84D 



Initialization 

On entry $Cs $s0 anything 

On exit $Cs $s0 (unchanged) 

$C800 space is enabled. Firmware initializes SSC to default 

values plus SW1 and SW2 selections. 



Read 

On entry $Cs $s0 anything 

On exit $Cs $Cs character in 

Notes: $C800 space is enabled. Pascal returns ACIA or keyboard data 
In the A Register and location $678+s with high bit cleared. 

$C9AA Write 

On entry $Cs $s0 character out 

On exit error code $Cs (changed) 

Notes: $C800 space is enabled. Output character Is transmitted 
through the ACIA. Pascal posts error code to IORESULT. 

Table A-10. Pascal 1.0 Entry Points Used by SSC 



PASCAL 1.1 ENTRY POINTS 



The Pascal 1.1 entry point protocol is outlined in the first section 
of this appendix. The values given here are the addresses of the 
routines. Unlike Pascal 1.0, Pascal 1.1 enters these routines using 
indirect addressing. 
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HI 

3 

3 
3 



i 4 
S 4 



Addr. 



Offset for 



Value X Register Y Register A Register 



$Cs0D Initialization $(Cs)8E 

On entry $Cs $s0 anything 

On exit $00 $s0 (changed) 

Notes: $C800 space Is enabled. Firmware initializes SSC to default 
values plus SW1 and SW2 selections. 

$Cs0E Read $(Cs)94 

On entry $Cs $S0 anything 

On exit error code $Cs char. In 

Notes: $C800 space is enabled. Character In from ACIA or keyboard 
is returned in the A Register. 

$Cs0F Write $(Cn)97 

On entry $Cs $ s char, out 

On exit error code $Cs (changed) 

Notes: $C800 space is enabled. The byte in the A Register is sent 
out through the ACIA. 

$Csl0 Status $(Cs)9A 

On entry $Cs $s0 request (0 or 1) 

On exit error code $s0 error code 

Notes: $C800 space is enabled. Request ' asks ACIA whether It is 

'ready to transmit another byte; request ■ 1 asks ACIA whether 
it has an input character available. On exit, carry bit - 
for Yes or 1 for No. 



Table Aril. Pascal 1.1 Offsets Used by SSC 

OTHER SPECIAL FIRMWARE LOCATIONS 

The SSC firmware uses several other addresses for predefined purposes. 
Table A-12 lists these locations. 

Address Value Purpose 

$Cs05 $38 Pascal serial/firmware card identifier 

(as well as BASIC input entry point) 
$Cs07 $18 Pascal serial/firmware card identifier 

(as well as BASIC output entry point) 
$Cs0B $01 Pascal 1.1 generic signature byte 

($01 = firmware card) 
$Cs0C $31 Pascal 1.1 Device Signature byte 

($31 = serial or parallel I/O card #1) 
$Csll $85 Pascal 1.1 optional routines flag 

(nonzero value = not supported) 
$CsFF $08 Firmware revision level 



Table A-12. SSC Special Firmware Locations 
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SSC FIRMWARE LISTINGS 



0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 

oooo 

0000 
0000 
0000 
0000 

oooo 

0024 

0026: 

0027 

0028 

0035 

002A 

002B 

0036 

0037 

0038 

0039 

003C 

004E 

004F 

0000 

OOOO 

OOOO 

0100 

0200: 

COOO: 

C010: 

CFFF: 

OOOO: 

OOOO: 

OOOO: 

C081 : 

C082: 

C088: 

C088: 

C089: 

C089: 

C08A: 

COBB: 



..«......«».«.......».•...»•«.... 



* APPLE II SSC FIRMWARE 



BY LARRY KENYON 
-JANUARY 1981- 



*»***»**#.#»** 



2 
3 
4 
5 
6 
7 

8 * * 

9 • (C) COPYRIGHT 1981 BY APPLE COMPUTER, INC. » 

10 * * 

1 1 *#******•***•*.*#»*******•***#**»**********#.* 

12 * * 

13 * VARIABLE DEFINITIONS * 

14 * * 

15 ........a.*.**********.*****.**** 

lg *****.*•****#**»** 

17 * ZERO PAGE EQUS * 

13 «••»*.»••»«..*•«•» 

19 CH EQU S24 

20 SL0T16 EQU $26 

21 CHARACTER EQU $27 

22 BASL EQU $28 

23 ZPTEMP EQU $35 
$2A 
$2B 
$36 
$37 
$38 
$39 
$3C 
$4E 
$4F 

33 ****»****.*»#*****. 

34 * GENERAL EQUATES * 

35 ft******..**.***.*.. 

36 STACK EQU $100 

37 INBUFF EQU 

38 KBD EQU 

39 KBDSTRB EQU 

40 ROMSOFF EQU 
41 



24 


ZPTMP1 


EQU 


25 


ZPTMP2 


EQU 


26 


CSWL 


EQU 


27 


CSWH 


EQU 


28 


KSWL 


EQU 


29 


KSWH 


EQU 


30 


A1L 


EQU 


31 


RNDL 


EQU 


32 


RNDH 


EQU 



$200 
$COO0 
SC010 
$CFFF 

************** ******** 

42 * SSC CARD ADDRESSES * 

43 ...................... 

44 DIPSW1 EQU SC081 

45 DIPSW2 EQU $C082 

46 TDR EG EQU $C088 

47 RDREG EQU $C088 

48 STREG EQU $C089 

49 RESET EQU $C089 

50 CMDREG EQU $C08A 

51 CTLREG EQU $C08B 



CURSOR HORIZONTAL POSITION 
SAVE $N0 TO FREE UP Y-REG 
OUTPUT, SCREEN AND INPUT CHARS 
BASE SCREEN ADDRESS POINTER 
WORKHORSE TEMPORARY 
WHEN ZPTEMP ISN'T ENOUGH 
TEMPORARIES, TEMPORARIES! 
CHAR OUT VECTOR 

CHAR IN VECTOR 

BATCH MOVE POINTER 
RANDOM NUMBER SEED 



.-SYSTEM STACK BLOCK 

; SYSTEM INPUT BUFFER 

j KEYBOARD INPUT 

; KEYBOARD CLEAR 

(DISABLES CO-RES. SC800 ROMS 



(+$N0) DIPSWITCH BLOCK 1 
(+$N0) DIPSWITCH BLOCK 2 
(+$N0) TRANSMIT DATA REG (WRITE) 
(+$N0) READ DATA REG (READ) 
(+$N0) STATUS REGISTER (READ) 
(♦$NO) SOFTWARE RESET (WRITE) 
(+$NO) COMMAND REGISTER (R/W) 
(+SN0) CONTROL REGISTER (R/W) 



3 
3 

■J 
3 



0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000 

0000 

0000 

0000 

0000 

oooo 
oooo 

0538 

0438 

0438 

04B8 

0000: 

0000 

0000 

0000 

0000 

0000 

OOOO 

OOOO 

oooo 
oooo 
oooo 
oooo 
oooo 

03B8 

oooo 
oooo 
oooo 
oooo 
oooo 

OOOO: 

OOOO 

OOOO 

OOOO 

OOOO 

OOOO 

oooo 

05BB 

0638: 

06B8 

0738 

OOOO 

OOOO 

OOOO 

OOOO 

oooo 



BIT-> B7 B6 B5 B4 B3 B2 



II BO 



• DIPSW1 SI S2 S3 S4 



S5 S6 



53 

54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 

67 « 

68 **************•*********..*..*..**•*********»**•#***.****** 

69 *•**•*••*••*******•******************•* 

70 
71 

72 CMDBYTE EQU $5F8-$C0 ; HOLDS COMMAND CHARACTER ( PPC £ CIC) 

73 HANDSHKE EQU $4F8-$C0 ;SIC P8A CHAR COUNTER FOR ETX/ACK 

74 PARAMETER EQU $4F8-$C0 ; ACCUMULATOR FOR CMD PARAMETER 

75 STATEFLG EQU $578-$C0 ,- 

76 * B7-CR GEN ENB FLAG B6=AFTER LC INPUT FLG 
B2-B0=COMMAND INTERPRETER STATES 



(LEFT DIPSWITCH) 

* 

* (S1-S4 USED FOR BAUD RATE, S5-S6 FOR FIRMWARE MODE) 

* 

* DIPSW2 SI Z S2 Z S3 S4 S5 CTS (RIGHT DIPSWITCH) 

* STREG INT DSR DCD TDR RDR OVR FE PE 

* 

* CTLREG STB << WL >> CK << BAUD RATE >> 

* 

* CMDREG <<PARITY >> ECH <<XMIT>> RE DTR 



SCREEN VARIABLES: PPC AND SIC MODES * 





1 

1 

1 1 





1 

1 



IDLE 

CMD CHAR RECEIVED 

COLLECT <N> UNTIL CHAR THEN DO COMMAND 

SKIP UNTIL SPACE, THEN GOTO STATE 4 

E/D COMMANDS 

UNUSED 

WAIT UNTIL CR THEN SET STATE TO ZERO 

WAIT UNTIL CR THEN DO PROC INDICATED BY PARM 



77 
78 
79 

so 

81 
82 
83 
94 

lib 

87 

88 * 

89 DELAYFLG EQU $478-$C0 

90 * B7-B6=SCREEN TRANSLATION OPTIONS 
LC->UC 

1 NO TRANSLATION 

1 LC->UC INVERSE 
1 1 LC->UC, UC->UC INVERSE 
(1-3 WILL ALLOW LC CHARS TO PASS THRU MONITOR) 



(B4-B0 DETERMINE ENQUIRE CHAR FOR P8A MODE) 



B5-B4-CR DELAY 
B3-B2=LF DELAY 
B1-B0»FF DELAY 



1 



91 
92 
93 
94 
95 
96 
97 
98 
99 
100 

101 * 

102 STSBYTE EQU $678-$CO 

103 PWDBYTE EQU $6F8-$C0 

104 COLBYTE EQU $778-$C0 

105 MISCFLG EQU $7F8-$C0 

1 06 • B7-ECHO BIT 

107 * B5=LINEFEED EAT 

108 » B3=XOFF ENB FLAG 

109 * B1=PPC/CIC MODE 
110* 



- NO DELAY 



32 MILLISEC 





10=1/4 SEC 

11 = 2 SEC 



STATUS/IORESULT/INPUT BYTE 
PRINTER (FORMAT) WIDTH 
COLUMN POSITION COUNTER 
I 

B6=TABBING OPTION ENABLE 

B4=PASCAL/BASIC FLAG 

B2=KEYBOARD ENB 

B0=LF GENERATE ENB 
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S * 



FIRMWARE 59 



T 



0000: 

0000: 

0000: 

07F8: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0638: 

0000: 

0000: 

0000: 

06B8: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000 

0000 

0000 

0000 

0000: 

FDED: 

PE89: 

FF58: 

FCBA: 

FE93: 

FDF6: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 



STATEFLG: B7=TERMINAL MODE FLAG 
B3-B5-CHAIN SLOT 



112 *************************************** 

U3« TEMP SCREEN VARS ( SLOT INDEPENDENT) * 

1 14 A************************************** 

115 mslot equ s7f8 ,-buffer for hi slot addr ($cn) 

1 16 a********************************* 

117 • screen variables: cic mode » 

1 18 ********************************** 

119 * 
120 
121 

122 • 

123 CHNBYTE EQU S6F8-SC0 

124 * 

125 • BO-B7-CN0O ENTRY 

126 * 

127 BUFBYTE EQU $778-$CO 

128 * 

129 • 

130 * 
131 
132 
133 

134 * 

135 ft********************** 

136 * MONITOR SUBROUTINES • 

137 *********************** 



MISCFLG: 



;CURRENT OUTPUT SCREEN ( SCNOO ENTRY) 



j BUFFER FOR ONE 
INPUT BYTE: HIGH BIT IS SET 
WHEN BUFFER IS FULL 

B6=TERM MODE SHIFT ENB 



OTHER SLOT VARIABLES AS DEFINED FOR PPC AND SIC MODES 



138 COUT 

1 39 SETKBD 

140 IORTS 

141 NXTA1 

142 SETSCR 

143 VIDOUT 
144 

1 
2 
3 
4 
5 
6 
7 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
CHN 



SFDED 
SFE89 
SFF58 
SFCBA 
SFE93 
SFDF6 
SSC.CNOO 



.-CHARACTER OUT (THRU CSW) 

,-SETS KSW TO APPLE KEYBOARD 

; KNOWN "RTS" LOCATION 

(INCREMENT A1H.L AND CMP TO A2H.L 

;SETS CSW TO APPLE SCREEN 

/OUTPUT A CHAR TO APPLE SCREEN 



********************************* 



* APPLE II SSC FIRMWARE 



BY LARRY KENYON 



-JANUARY 1981- 



************** 



9 
10 

11 
12 
13 
14 
15 



* (C) COPYRIGHT 1981 BY APPLE COMPUTER, INC. * 



a********************************************* 



• CNOO SPACE CODE 



58 
OC 



C700: 

C700: 

C700:2C 

C703:70 

C705:38 

C706:90 

C707:18 

C708:B8 

C7O9:50 06 



********************************* 
NEXT OBJECT FILE NAME IS SSC.DCLS.OBJO 
1 6 ORG SC700 



gt 



17 • 

18 BINIT 
19 

20 IENTRY 

21 

22 OENTRY 

23 

24 



BIT 
BVS 
SEC 
DFB 
CLC 
CLV 
BVC 



IORTS (SET THE V-FLAG 

BENTRY ;<ALWAYS> 

(BASIC INPUT ENTRY 
S90 (OPCODE FOR BCC 

(BASIC OUTPUT ENTRY 

BENTRY (<ALWAYS> SKIP AROUND PASCAL 1.1 ENTRY 



H 
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4 



C70B:01 






25 




DFB 


$01 


C70C:31 






26 




DFB 


S31 


C70D:8E 






27 




DFB 


>PINIT 


C70E:94 






28 




DFB 


>PREAD 


C70F:97 






29 




DFB 


>PWRITE 


C710:9A 






30 




DFB 


>PSTATUS 


C71l:85 


37 




31 


BENTRY 


STA 


CHARACTER 


C713:86 


3S 




32 




STX 


ZPTEMP 


C715:8A 






33 




TXA 




C716:48 






34 




PHA 




C717:98 






35 




TYA 




C718:48 






36 




PHA 




C719:08 






37 




PHP 




C71A:78 






38 




SEI 




C71B:8D 


FF 


CF 


39 




STA 


ROMSOFF 


C71E:20 


58 


FF 


40 




JSR 


IORTS 


C721:BA 






41 




TSX 




C722:BD 


00 


01 


42 




LDA 


STACK, X 


C725:8D 


F8 


07 


43 




STA 


MSLOT 


C728:AA 






44 




TAX 




C729:0A 






45 




ASL 


A 


C72A:0A 






46 




ASL 


A 


C72B:0A 






47 




ASL 


A 


C72C:0A 






48 




ASL 


A 


C72D:85 


26 




49 




STA 


SLOT16 


C72F:A8 






50 




TAY 




C730:28 






51 




PLP 




C731-.50 


29 




52 




BVC 


NORM 10 


C733: 






53 


* 






C733: 






54 


* BASIC 


INITIALIZATION 


C733: 






55 


* 






C733:1E 


:«h 


05 


56 




ASL 


CMDBYTE, X 


C736:5E 


ta 


05 


57 




LSR 


CMDBYTE, X 


C739:B9 


8A 


CO 


58 




LDA 


CMDREG, Y 


C73C:29 


1F 




59 




AND 


#S1F 


C73E:D0 


05 




60 




BNE 


BINITI 


C740:A9 


EF 




61 




LDA 


#SEF 


C742:20 


05 


C8 


62 




JSR 


INIT1 


C745: 






63 


* 






C745:E4 


37 




64 


BINITI 


CPX 


CSWH 


C747:D0 


01) 




65 




BNE 


FROMIN 


C749:A9 


07 




66 




LDA 


S>OENTRY 


C74B:C5 


36 




67 




CMP 


CSWL 


C74D:F0 


OS 




68 




BEQ 


FROMIN 


C74F:85 


36 




69 




STA 


CSWL 


C751 :18 






70 


FROMOUT 


CLC 




C752:90 


08 




71 




BCC 


NORM 10 


C754:E4 


39 




72 


FROMIN 


CPX 


KSWH 


C756:D0 


F9 




73 




BNE 


FROMOUT 


C758:A9 


05 




74 




LDA 


#>IENTRY 


C75A:85 


38 




75 




STA 


KSWL 


C75C: 






76 


• 






C75C: 






77 


• BRANCH TO 


APPROPRIAT 


C75C: 






78 


* 






C75C:BD 


38 


07 


79 


NORM 10 


LDA 


MISCFLG, X 


C75F:29 


02 




80 




AND 


#$02 


C761 :08 






81 




PHP 




C762:90 


03 




82 




BCC 


BOUTPUT 



(GENERIC SIGNATURE BYTE 
(DEVICE SIGNATURE BYTE 



( INPUT BUFFER INDEX 
(SAVE X AND Y REGS ON STACK 



(SAVE ENTRY FLAGS 

(NO RUPTS DURING SLOT DETERMINATION 
(SWITCH OUT OTHER SC800 ROMS 



(RECOVER SCN 

(X-REG WILL GENERALLY BE SCN 
(DETERMINE $N0 



(Y-REG WILL GENERALLY BE SNO 
(RESTORE RUPTS 



(ALWAYS ENABLE COMMANDS 

(JUST HAD A POWER-ON OR PROGRAM RESET? 

[IF SO, GO JOIN INIT IN PROGRESS 



[IF CSW IS ALREADY POINTING TO OENTRY, 

| THEN WE MUST HAVE COME FROM KSW 

[OTHERWISE, SET CSW TO OENTRY 

(INDICATE WE ARE CALLED FOR OUTPUT 

[<ALWAYS> 

[MAKE SURE KSW POINTS HERE 



[SET UP KSW (NOTE CARRY SET FROM CPX) 
; BASIC I/O ROUTINE 

[SEPARATE CIC MODE FROM OTHERS 
[NOT ZERO FOR CIC MODE 
[SAVE CIC MODE INDICATION 
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C764:4C 

C767: 

C767:BD 

C76A:48 

C76B:0A 

C76C:10 

C76E:A6 

C770:A5 

C772:09 

C774J9D 

C777:85 

C779:AE 

C77C:68 

C77D:29 

C77F:9D 

C782:28 

C783:F0 

C785:20 

C788:4C 

C78B: 

C78B:4C 

C78E: 

C78E: 

C78E: 

C78E: 

C78E: 

C78E:20 

C791:A2 

C793:60 

C794:4C 

C797:4C 

C79A: 

C79A: 

C79A: 

C79A: 

C79A: 

C79A: 

C79A:4A 

C79B:20 

C79E:B0 

C7A0:20 

C7A3:F0 

C7A5:I8 

C7A6:90 

C7A8: 

C7A8:20 

C7AB:BD 

C7AE:AA 

C7AF:60 

C7B0: 

C7B0: 

C7B0: 

C7B0:A2 

C7B2:B5 

C7B4:48 

C7B5:CA 

C7B6: 10 

C7B8: 



BF C8 
B8 04 



0E 

35 

27 

20 

00 02 

27 

F8 07 

BF 
B8 04 

06 

63 CB 
B5 C8 

FC C8 



00 C8 
00 



9B C8 
AA C9 



9B C9 
08 

F5 CA 
06 



D2 CA 
B8 05 



83 

84 * 

85 BOUTPUT LDA 
PHA 



JMP BINPUT 



STATEFLG.X jCHECK FOR AFTER LOWERCASE INPUT 



;SKIP IF NOT 



A 

BOUTPUT! 

ZPTEMP 

CHARACTER 

»S20 

INBUFF.X ; RESTORE LOWERCASE IN BUFFER 

CHARACTER ;AND FOR OUTPUT ECHO 

MSLOT 



86 

87 ASL 

88 BPL 

89 LDX 

90 LDA 

91 ORA 

92 STA 

93 STA 

94 LDX 

95 BOUTPUT1 PLA 

96 AND 

97 STA 

98 PLP 

99 BEQ 

100 JSR 

101 JMP 

102 * 

103 BOUTPUT2 JMP SEROUT 

104 **««•**•••*•«*«»••*•*••*•••«••*«•• 

105 • * 

106 • NEW PASCAL INTERFACE ENTRIES * 

107 » * 

108 ********************************** 

109 PINIT JSR PASCALINIT ; 



#SBF 
STATEFLG.X 

BOUTPUT2 

OUTPUT 

CICEXIT 



;ZERO THE FLAG 

; RETRIEVE CIC MODE INDICATION 

; BRANCH FOR PPC, SIC MODES 

;CIC MODE OUTPUT 

; FINISH BY CHECKING FOR TERM MODE 



110 
111 



LDX 
RTS 
1 1 2 PREAD JMP 

113 PWRITE JMP 

114 * 
115 
116 
117 
118 

119 * 

120 PSTATUS LSR 
JSR 



#0 



;NO ERROR POSSIBLE 



PASCALREAD j 
PASCALWRITE | 



NEW PASCAL STATUS REQUEST 

A-REG-0 -> READY FOR OUTPUT? 
A-REG-1 -> HAS INPUT BEEN RECEIVED? 



121 
122 
123 
124 
125 
126 

127 * 

128 PSTATIN JSR 



BCS 
JSR 
BEQ 
CLC 
BCC 



A 

PENTRY 
PSTATIN 
SROUT 
PSTATUS 2 



,-SAVE REQUEST TYPE IN CARRY 
;( PRESERVES CARRY) 

; READY FOR OUTPUT? 



PSTATUS2 ;CARRY CLEAR FOR NOT READY 



SRIN 



;SETS CARRY CORRECTLY 



129 PSTATUS 2 LDA STSBYTE, X ;GET ERROR FLAGS 



1 30 TAX 

131 RTS 

132 a********************************************** 

1 33 * ROUTINE TO SEND A CHARACTER TO ANOTHER CARD * 
1 34 A********************************************** 

03 1 35 SENDCD LDX #3 

36 1 36 SAVEHOOK LDA CSWL, X 

1 37 PHA 

1 38 DEX 

FA 139 BPL SAVEHOOK 

140 « 



62 SUPER SERIAL CARD 



H 
=! 

H 

a 

3 
H 

-J 
1 



C7B8: 




141 • 


NOW 


PUT CARD ADDRESS IN HOOK 


C7B8: 




142 • 








C7B8:AE F8 


0? 


143 




LDX 


MSLOT 


C7BB:BD 38 


06 


144 




LDA 


CHNBYTE, X 


C7BE:85 36 




145 




STA 


CSWL 


C7C0s8D B8 


04 


146 




LDA 


STATEFLG.X ,-GET SLOT « 


C7C3.-29 38 




147 




AND 


»S38 


C7C5:4A 




148 




LSR 


A 


C7C6:4A 




149 




LSR 


A 


C7C7:4A 




150 




LSR 


A 


C7C8:09 CO 




151 




ORA 


SSCO ;FORM SCN 


C7CA:85 37 




152 




STA 


CSWH 


C7CC: 




153 « 








C7CC: 




154 « 


OUTPUT TO 


THE PERIPHERAL 


C7CC: 




155 • 








C7CC:8A 




156 




TXA 


,-SAVE SCN 


C7CD:48 




157 




PHA 




C7CE:A5 27 




158 




LDA 


CHARACTER 


C7D0:48 




159 




PHA 




C7D1:09 80 




160 




ORA 


*S80 ;80 COL BOARDS WANT HI-BIT ON 


C7D3:20 ED 


ro 


161 




JSR 


COUT 


C7D6: 




162 * 








C7D6: 




163 * 


NOW 


RESTORE EVERYTHING THE OTHER CARD MAY HAVE CLO 


C7D6: 




164 « 








C7D6:68 




165 




PLA 




C7D7:85 27 




166 




STA 


CHARACTER 


C7D9:68 




167 




PLA 




C7DA:8D F8 


07 


168 




STA 


MSLOT 


C7DD:AA 




169 




TAX 




C7DE:0A 




170 




ASL 


A 


C7DF:0A 




171 




ASL 


A 


C7E0:0A 




172 




ASL 


A 


C7E1 :0A 




173 




ASL 


A 


C7E2:85 26 




174 




STA 


SLOT16 


C7E4:8D FF 


CF 


175 




STA 


ROMS OFF 


C7E7: 




176 * 








C7E7: 




177 * 


PUT 


BACK CSWL INTO CHNBYTE 


C7E7: 




178 * 








C7E7:A5 36 




179 




LDA 


CSWL 


C7E9:9D 38 


06 


180 




STA 


CHNBYTE, X 


C7EC: 




181 « 








C7ECJA2 00 




182 




LDX 


#0 


C7EE:68 




183 RESTORHOOK PLA 


C7EF:95 36 




184 




STA 


CSWL.X 


C7F1 : E8 




185 




INX 




C7F2:E0 04 




186 




CPX 


#4 


C7F4:90 F8 




187 




BCC 


RESTORHOOK 


C7F6: 




188 « 








C7F6:AE F8 


7 


189 




LDX 


MSLOT 


C7F9:60 




190 




RTS 




C7FAi 




191 * 








C7FA:C1 DO 


DO 


192 




ASC 


"APPLE" 


C7FD:CC C5 












C7FF:08 




193 




DFB 


S8 


C800: 




194 * 
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C800 
C800 
C800 
C800 
C800 
C800 
C800 
C800 
C800 
C800 
C800 
C800 
C800 
C800 
C800 
C800 
C800 
C800 



196 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 



CHN SSC.C800 

******** .............. .......... 



* APPLE II SSC FIRMWARE 



BY LARRY KENYON 



-JANUARY 1981- 



i 



************* 



» (C) COPYRIGHT 1981 BY APPLE COMPUTER, INC. » 



********************************************** 



* C800 SPACE: HIGH LEVEL STUFF • 



CBOO: 
C800: 
C803: 
C805: 
C806: 
C808: 
C80B: 
C80E: 
C81 1: 
C814: 
C817: 
C81A: 
C81D: 
C81F: 
C820: 
C821: 
C823: 
C824: 
C826: 
C827: 
C828: 
C82B: 
C82C: 
C82E: 
C82F: 
C831: 
C833 
C835 
C835 
C836 
C838 
C83A 
C83C 
C83F 
C842 
C844 
C846 
C848 
C84B 



20 9B 
A9 16 
48 

A9 00 
9D B8 
9D B8 
9D 38 
9D B8 
9D 38 
9D B8 
B9 82 
85 2B 
4A 
4A 

90 04 
68 

29 FE 
48 
B8 

B9 81 
4A 

BO 07 
4A 

BO OE 

A9 01 

:D0 3D 

:4A 

:A9 03 
:B0 02 
:A9 80 
:9D B8 
:2C 58 
:A5 2B 
:29 20 
:49 20 
:9D B8 



15 ********************************* 

16 * PASCAL 1.0 INIT ENTRY * 

17 ************************* 

OBJECT FILE NAME IS SSC . DCLS . OB J 1 

1 8 ORG SC800 
C9 19 PASCALINIT JSR PENTRY j PASCAL 1.0 INITIALIZATION ENTRY 



04 
03 
04 
05 
06 
06 

CO 



04 
ft 



3 



20 

21 INIT1 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 INIT1A 

38 

39 

40 

41 

42 

43 

44 

45 * 

46 INIT2 
47 

48 
49 

50 INIT2A 

51 INIT2B 
52 

53 
54 
55 
56 • 



LDA 
PHA 
LDA 
STA 
STA 
STA 
STA 
STA 
STA 
LDA 
STA 
LSR 
LSR 
BCC 
PLA 
AND 
PHA 
CLV 
LDA 
LSR 
BCS 
LSR 
BCS 
LDA 
BNE 

LSR 
LDA 
BCS 
LDA 
STA 
BIT 
LDA 
AND 
EOR 
STA 



#$16 

10 

STATEFLG, X 

DELAYFLG.X 

HANDS HKE, X 

STSBYTE, X 

PWDBYTE, X 

COLBYTE, X 

DIPSW2, Y 

ZPTMP2 

A 

A 

INIT1A 



,-NO XOFF, ECHO, LF EAT, OR LF GEN 
,-GOES TO MISCFLG AFTER MODIFICATION 



#$FE 



DIPSW1 , Y 

A 

INIT2 

A 

INIT2B 

#$01 

INIT5 



,-SET LF GEN OPTION FROM D2-S5 

,-SAVE FOR LATER 

;S5-> CARRY 

,-IP S5»ON=0 THEN LEAVE MISCFLG ALONE 

;OTHERWISE, MAKE SURE LF GEN 
; ENABLE IS RESET 

;V WILL BE CLEAR FOR CIC MODE 

;SIC MODES SET CARRY 
.•BRANCH FOR SIC MODES 

;PPC MODE BRANCH 

;CTL-A 

;<ALWAYS> CIC MODE BRANCH 



A ;SET CARRY FOR P8A 

#$03 ;SET ETX AS DEFAULT INQUIRY CHAR 

INIT2A ; BRANCH FOR P8A 

#$80 ;FOR P8 SET AUTO CR GEN 

STATEFLG, X 

IORTS (SET V-FLAG FOR PPC, SIC MODES 

ZPTMP2 

#$20 ;SET CR DELAY 

#$20 ;SO 1=ENB, 0-DISABLE 

DELAYFLG, X ; FROM D2-S2 



H 

a 

=4 
3 

- 
-! 



C84B:70 

C84D: 

C84D: 

C84D: 

C84D: 

C84D:20 

C850:AE 

C853:9D 

C856:60 

C857: 

C857: 

C857: 

C857: 

C857:A5 

C859-.4A 

C85A:4A 

C85B:29 

C85D: A8 

C85E:F0 

C860: 

C860:68 

C861:29 

C863:48 

C864: 

C864:B9 

C867:9D 

C86A: A4 

C86C: 

C86C:68 

C86D:29 

C86P:48 

C870:A9 

C872: 

C872:9D 

C875:68 

C876:9D 

C879: 

C879: 

C879: 

C879:A5 

C87B:48 

C87C:29 

C87E:50 

C880:29 

C882:20 

C885:20 

C888:68 

C889:29 

C88B:50 

C88D: A9 

C88F:0A 

C890:0A 

C891 : OA 

C892:09 

C894:99 

C897:B9 

C89A:60 

C89B: 



OA 



9B C8 
F8 07 
B8 05 



A6 C9 
38 06 
26 



95 
09 

38 05 
38 07 

2B 

AO 
02 
80 

A1 CD 
81 CD 

OC 
02 
00 



OB 

8A CO 
88 CO 



57 BVS INIT3 ;<ALWAYS> BRANCH AROUND PASCAL 

5g ************************** 

59 * PASCAL 1.0 READ ENTRY « 

60 * (MUST BE AT $C84D) * 

61 ************************* 

62 PREADO JSR PASCALREAD ;DO PASCAL 1.1 READ 

63 LDX MSLOT ; MODIFY FOR 1.0 

64 STA STSBYTE, X ;CHARACTER READ 

65 RTS 

••A********************* 



« NOW WHERE WERE WE??? * 
A*********************** 



66 
67 
68 

69 • 

70 INIT3 
71 

72 

73 

74 

75 

76 • 

77 

78 

79 

80 • 

81 INIT4 
82 

83 

84 * 

85 

86 

87 

88 

89 * 

90 INIT5 
91 

92 

93 * 

94 

95 

96 

97 

98 

99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
1 1 1 
1 12 
113 



LDA 
LSR 
LSR 
AND 
TAY 

BEg 

PLA 
AND 
PHA 

LDA 
STA 
LDY 

PLA 
AND 
PHA 
LDA 

STA 
PLA 
STA 



ZPTMP2 

A 

A 

#$03 

INIT4 



#$7F 



;PPC, SIC MODES USE SWITCHES 
; TO SET PWIDTH, CR DELAY 



.-RESET VIDEO ENABLE FOR PWIDTH#40 



PWDTBL, Y 
PWDBYTE, X 
SLOT16 



i CLEAR CIC BIT IN FUTURE MISCFLG 

I (AND TABBING, XOFF AND LF EAT BITS) 



#$95 

#$09 ,-CTL-I 

CMDBYTE.X ;CMD ESC CHAR (IGNORED FOR SIC MODES) 

MISCFLG, X ;SET MISCFLG FLAGS 



NOW FOR THE ACIA INITIALIZATION ROUTINE 



INITACIA LDA ZPTMP2 
PHA 

AND #$A0 

BVC INITACIA 1 

AND #$80 

INITACIAt JSR DATACMD1 

JSR BAUDCMD1 
PLA 

AND #$0C 

BVC INITACIA2 

LDA #$0 

INITACIA2 ASL A 

ASL A 

ASL A 

ORA #$0B 

STA CMDREG.Y 

LDA RDREG.Y 
RTS 



;DIPSW2 

;DATA BIT OPTIONS FOR CIC MODE 

; BRANCH FOR CIC MODE 

;8 DATA, 1 OR 2 STOP POR SIC, PPC 

;SET CONTROL REG 

(SET DIPSWITCH BAUD RATE 

; PARITY OPTIONS FOR CIC MODE 

.-BRANCH FOR CIC MODE 

(DISABLE PARITY FOR SIC, PPC MODES 



; THROW OUT THE STRANGE STUFF 



114 ******************** 



64 SUPER SERIAL CARD 



S -1 
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C89B: 

C89B: 

C89B:20 9B C9 

C89E:20 AA C8 

C8AI :29 7F 

C8A3:AC F8 07 

C8A6:8E B8 05 

C8A9:60 

C8AA: 

C8AA: 

C8AA: 

C8AA: 

C8AA: 

C8AA: 

C8AA: 

C8AA: 

C8AA: 

C8AA:20 FF CA 

C8AD:B0 05 

C8AF:20 2C CC 

C8B2:90 F6 

C8B4:60 

C8B5: 

C8B5: 



STSBVTE, Y | ERROR STATUS-) X-REG 



11 5 * PASCAL READ ROUTINE » 

116 ....................... 

117 PASCALREAD JSR PENTRY ;SHARED BY BOTH PASCAL VERSIONS 

118 PASCALREAD1 JSR GETCHAR ;GET ACIA/KBD DATA 

119 AND #S7F ;CLEAR HIGH BIT FOR PASCAL 

1 20 PASEXIT LDY MSLOT 

121 LDX 

122 RTS 

123 .•...****.***.**..*.**...**... 

124 * GETCHAR ROUTINE WAITS FOR * 

125 * THE NEXT CHAR FROM EITHER * 

126 * THE ACIA OR KEYBOARD (IF • 

127 « ENABLED). USED BY PASCAL * 

1 28 * READ ROUTINE, XON WAIT, * 

129 * AND ACK WAIT. DATA IS RE- * 

130 * TURNED IN THE A-REGISTER * 

131 *..****.......*.***.*......... 



I 



•i 



1 32 GETCHAR JSR 

133 BCS 

134 JSR 

135 BCC 

136 GETCHAR1 RTS 

137 • 

138 CHN 



INPUT 
GETCHAR1 
CKKBD 
GETCHAR 



,-ACIA DATA? 

; KEYBOARD INPUT? 

;EXIT WHEN WE HAVE SOMETHING 



SSC.HILEV 



66 SUPER SERIAL CARD 



=3 
H 

_- 
Si 

3 
3 

3 
3 

3 



C8B5: 

C8B5: 

C8B5: 

C8B5: 

C8B5: 

C8B5: 

C8B5: 

C8B5: 

C8B5: 

C8B5: 

C8B5: 

C8B5: 

C8B5: 

C8B5: 

C8B5: 

C885: 

C8B5: 

C8B5:20 

C8B8: 

C8B8: 

C8B8: 

C8B8:68 

C8B9:A8 

C8BA:68 

C8BB:AA 

C8BC:A5 

C8BE:60 

C8BF: 

C8BF: 

C8BF: 

C8BF:F0 

C8C1 :BD 

C8C4:10 

C8C6:5E 

C8C9:D0 

C8CB: 

C8CB:20 

C8CE:90 

C8D0: 

CBD0:BD 

C8D3:29 

C8D5:F0 

C8D7:A5 

C8D9:C9 

C8DB:90 

C8DD: BD 

C8E0:09 

C8E2:9D 

C8E5: 

C8E5.-28 

C8E6:F0 

C8E8:D0 

C8EA: 

C8EA:20 

C8ED:90 

C8EF:20 

C8F2:28 

C8F3.-08 



IE CA 



29 

B8 06 
05 

B8 06 
24 

3E CC 

1A 

B8 03 

CO 

OE 

27 

EO 

08 

B8 04 

40 

B8 04 



DO 

CB 

FF CA 

DC 

11 CC 



• APPLE II SSC FIRMWARE 



BY LARRY KENYON 



-FEBRUARY 1981- 



.....*.....**• 



2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 

15 • * 

15 ..•*.****.•**.***«**«.«*.*.****•* 

17 • CIC EXIT ROUTINE ... • 

13 .A.*******.********..*.*.***.**.* 

19 CICEXIT JSR CHECKTERM ;SEE IF WE'VE ENTERED TERMINAL MODE 

20 ****.*..*..**.****..*. 

21 * BASIC EXIT ROUTINE * 

22 .........*..»........» 

23 BASICEXIT PLA 



• (C) COPYRIGHT 1981 BY APPLE COMPUTER, INC. 



• CIC, SIC, PPC MODE HIGH-LEVEL * 



TAY 
PLA 
TAX 

LDA CHARACTER 
RTS 

...ft***.*.......*******. 

• BASIC INPUT ROUTINE • 



'•! 
25 
26 
27 
29 

29 

30 

31 ****** 

32 BINPUT 
33 
34 
35 
36 

37 * 

38 BINKBD JSR 

39 BCC 

40 * 

41 BINEND LDA 
AND 



BEQ 
LDA 
BPL 
LSR 
BNE 



BINACIA ; BRANCH IF NOT CIC MODE 

BUFBYTE, X ; INPUT BUFFER FULL? 

BINKBD 

BUFBYTE, X ; RESET BUFFER FULL 

BINACIA 1 ;<ALWAYS> 



GETKBD 
BINACIA 



; KEYBOARD DATA? 



DELAYFLG.X 

42 AND #SC0 

43 BEQ BINEND 1 

44 LDA CHARACTER 

45 CMP »SE0 

46 BCC BINEND1 

47 LDA STATEFLG.X 

48 ORA #$40 

49 STA STATEFLG, X 

50 • 

51 BINEND1 PLP 

52 BEQ 

53 BNE 

54 • 

55 BINACIA JSR 

56 BCC 

57 BINACIA1 JSR RESTORE 

58 PLP 

59 PHP 



TRANSLATE LOWERCASE TO UPPERCASE? 

IF SO, LET THE MONITOR DO IT 

IF NOT, SET FLAG IF 
THIS IS A LOWERCASE CHAR 
FOR INPUT BUFFER CORRECTION 

I (CIRCUMVENT APPLE MONITOR) 



BASICEXIT ; BRANCH IF NOT CIC MODE 
CICEXIT ,-<ALWAYS> CHECK TO SEE IF WE 

ENTERED TERM MODE (VIA KYBD ESCAPE 
INPUT ;ACIA DATA? 

BINKBD 

;DO BASIC CURSED DUTY 



;GET CIC MODE INDICATOR 



FIRMWARE 67 



T 



C8F4:F0 

C8F6: 20 

C8F9:4C 

C8FC: 

C8FC: 

C8FC: 

C8FC:20 

C8FFiB0 

C901:A5 

C903:48 

C904:BO 

C907:29 

C909:D0 

C90B: 

C90B:A5 

C90D:F0 

C90F:C9 

C91 1 :F0 

C913:C9 

C915:D0 

C917:09 

C919:3D 

C91C:18 

C91D:65 

C91F:85 

C921: 

C921 : 

C921 :BD 

C924:C5 

C926:F0 

C928:A9 

C92A.-90 

C92C:BD 

C92F:0A 

C930.-10 

C932:A9 

C934:85 

C936:2C 

C939:08 

C93A:70 

C93C:EA 

C93D: 

C93D: 

C93D: 

C93D: 

C93D: 

C93D: 

C93D:2C 

C94O:50 

C941:B8 

C942:AE 

C945:4C 

C948: 

C948: 

C948: 

C948:20 

C94B:20 

C94E:4C 



DA 

Dl C9 

DO C8 



1A CB 

B7 

27 

38 07 

CO 

16 

24 
42 
08 
04 
10 
OA 
FO 
B8 06 

24 
24 



B8 06 

24 

29 

AO 

08 

3fi 07 

1F 
88 
27 
58 FF 



F8 07 
EF C9 



B5 C9 
6B CB 
68 C9 



60 BEQ BINEND 

61 JSR CKINPUT 

62 JMP BINEND 

63 ******** ******** *********** ****** 

64 * SIC, PPC BASIC OUTPUT ROUTINE • 
55 ********************************* 



,-SKIP IF NOT CIC MODE 

,-LOOK FOR INPUT STREAM SPECIAL CHARS 



66 SEROUT 

67 

68 

69 

70 

71 

72 

73 * 

74 

75 

76 

77 

78 

79 

80 COMMA 

81 

82 

83 

84 

85 * 

86 • 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 

100 
101 
102 
103 
104 
105 
106 



JSR 
BCS 
LDA 
PHA 
LDA 
AND 
BNE 

LDA 
BEQ 
CMP 
BEQ 
CMP 
BNE 
ORA 
AND 
CLC 
ADC 
STA 



CMDSEQCK 

BASICEXIT 

CHARACTER 

MISCFLG, X 

#sco 

TABCHECK 

CH 

NOTAB 

#8 

COMMA 

#16 

TABCHECK 

#$F0 

COLBVTE, X 

CH 
CH 



,-CHECK FOR A COMMAND SEQUENCE 

,- BRANCH IF WE WERE IN COMMAND MODE 

;SAVE CHAR ON STACK 

j IF VIDEO OR TABBING ENABLED, 
; DON'T MESS WITH THE CURSOR 



; CHECK FOR COMMA TABBING 

;IF CH=0, THERE WAS NO TAB OR COMMA 

I INTEGER BASIC COMMA? 



; APPLESOFT COMMA? 



;SET COL TO PREVIOUS TAB 



,-THEN INCREMENT TO NEXT TAB 



TABCHECK LDA COLBVTE, X 

CMP CH 

BEQ NOTAB 

LDA »SA0 

BCC TAB1 

LDA MISCFLG, X 

ASL A 

BPL NOTAB 

LDA #$88 
TAB1 STA CHARACTER 

BIT IORTS 

PHP 

BVS TAB2 

NOP 
************************* 

* SHORT BATCH MOVE: * 

* LOCATE AT SC93D FOR * 

* COMPATIBILITY WITH • 

* SIC P8 BLOCK MOVE. * 
************************* 

107 BATCHIN BIT IORTS 

108 DFB $50 

109 BATCHOUT CLV 
1 1 LDX MSLOT 

1 1 1 JMP BATCHIO 

112 ********************* 

1 1 3 * BURP ... * 

114 ********************* 

1 15 TAB2 JSR ADJUST 

116 JSR OUTPUT2 

1 1 7 JMP FORCECR 



IS TABBING NEEDED? 

IF EQUAL THEN NO TAB NEEDED 

SPACE FOR FORWARD TAB 

.-DON'T BACKSPACE UNLESS TABBING 
; OPTION IS ENABLED 

; BACKSPACE FOR BACKTAB 

iSET V-1 TO INDICATE TABBING 
iSAVE TABBING INDICATOR 
;<ALWAYS> AROUND BATCH MOVE ENTRY 



; DUMMY BVC 

;V=0 FOR OUTPUT ENTRY 



; ADJUST COLUMN COUNT 

jDON'T GO TO SCREEN WHEN TABBING 

,-SHARE SOME CODE. . . 



s 

H 

H 

3! 
3 
■4 

A 
31 
3 



C951 : 

C95U68 

C952:B8 

C953:08 

C954:85 

C956:48 

C957:20 

C95A:20 

C95D:68 

C95E:49 

C960:OA 

C961 :D0 

C963:9D 

C966:85 

C968: 

C968:BD 

C96B: 10 

C96D:BD 

C970.-F0 

C972:18 

C97 3:FD 

C976: A9 

C978:90 

C97A: 

C97A:28 

C97B:70 

C97D: 

C97D:BD 

C980:30 

C982:BC 

C985:0A 

C986:30 

C988:98 

C989:A0 

C98B:38 

C98C:FD 

C98F:C9 

C991 :90 

C993:69 

C995:A8 

C996:84 

C998i 

C998:4C 

C99B: 

C99B: 

C99B: 

C99B: 

C99B:8E 

C99E:84 

C9A0: A9 

C9A2:9D 

C9A5:60 

C9A6: 

C9A6: 

C9A6 

C9A6 

C9A6: 29 

C9A7:48 



118 * 

1 1 9 NOTAB PLA 

1 20 CLV 

121 PHP 

122 NOTAB 1 STA 



68 CB 
B5 C9 

8D 

05 

B8 06 
24 

B8 04 
OD 

38 06 
08 

B8 06 

8D 

DA 



A4 

38 07 
16 
B8 06 

OE 

00 

38 06 
F8 
03 
27 

24 

B8 C8 



P8 07 
26 
00 
B8 05 



;SAVE 'NO TAB 1 INDICATION 
CHARACTER ;( FORCE CR REENTRY) 



PHA 
JSR 
JSR 
PLA 
EOR 
ASL 
BNE 
STA 
STA 



123 
124 
125 
126 
127 
128 
129 
130 
131 

132 * 

1 33 FORCECR LDA 
BPL 
LDA 
BEQ 
CLC 
SBC 
LDA 
BCC 



0UTPUT1 
ADJUST 



; ENTER AFTER CMD SEQ CHECK 



,-WAS IT A CR? 



#S8D 

A 

FORCECR 

COLBYTE, X ; IF SO, RESET COLUMN TO 

CH 



134 

135 

136 BEQ SEREND 

137 

1 38 SBC COLBYTE, X 

139 LDA #$8D 

140 BCC NOTAB1 

141 • 

142 SEREND PLP 

143 BVS 

144 * 

145 LDA 

146 BMI 

147 LDY 

148 ASL 

149 BMI 

150 TYA 

151 LDY 

152 SEC 

153 SBC 

154 CMP 

155 BCC 

156 ADC 

157 TAY 

158 SETCH STY 

159 « 

160 SEREND2 JMP 

161 « 

162 *************************** 

163 * PASCAL ENTRY ROUTINE * 

164 *************************** 

165 PENTRY STX MSLOT 



STATEFLG.X ,• FORCE CR DISABLED? 

SEREND 

PWDBYTE, X ; FORCE CR IF LIMIT REACHED 



i(FOR P8 POKE COMPATIBILITY) 



; BRANCH TO FORCE CR 



TABCHECK ,- BRANCH IF TABBING 



MISCFLG, X 

SEREND2 

COLBYTE, X 

A 

SETCH 

#0 

PWDBYTE, X 
#$F8 
SETCH 
#$27 

CH 



;DON'T MESS WITH CURSOR 
; WHEN VIDEO IS ON 



jSET CH TO VALUE OF COL FOR TABBING 

,-WITHIN 8 CHARS OF PWIDTH? 

;IP SO, ADJUST TO WITHIN 8 OF 40 



BASICEXIT .-THAT'S ALL 



166 
167 
168 
169 
170 
171 
172 



STY 
LDA 
STA 

RTS 



SLOT16 
#0 
STSBYTE, X 



******************************** 
* SIC MODE PRINTER WIDTH TABLE * 

173 ******************************** 

174 PWDTBL DFB $29 ,-40 COLUMNS 

175 DFB $48 ,-72 COLUMNS 



68 SUPER SERIAL CARD 






FIRMWARE 69 



1 



C9A8:50 




176 


DFB 


$50 ;80 COLUMNS 


C9A9:84 




177 


DFB 


S84 [132 COLUMNS 


C9AA: 




178 •*«*****»***••**•***•**• 


C9AA: 




179 * PASCAL WRITE ROUTINE • 


C9AA: 




180 • (DOUBLES AS PASCAL * 


C9AA: 




181 * 1.0 ENTRY 


POINT) • 


C9AA: 




182 • -MUST BE AT SC9AA- • 


C9AA: 




133 ft*********************** 


C9AA:85 27 




184 PASCALWRITE STA CHARACTER 


C9AC:20 9B 


C9 


185 


JSR 


PENTRY 


C9AFi20 63 


CB 


186 


JSR 


OUTPUT 


C9B2:4C A3 


C8 


187 


JMP 


PASEXIT ;LOAD X-REG WITH ERROR BYT 


C9B5: 




188 * 






C9B5: 




189 •*«**«•*««»*»«»**•••*»*»»•*•• 


C9B5: 




190 * COLUMN ADJUST ROUTINE * 


C9B5: 




191 * (PPC, 


SIC 


10DES ONLY) • 


C9B5: 




192 ****«**«********************* 


C9B5:A5 27 




193 ADJUST 


LDA 


CHARACTER 


C9B7:49 08 




194 


EOR 


#S08 ; BACKSPACE? 


C9B9:0A 




195 


ASL 


A 


C9BA:F0 04 




196 


BEQ 


DECRCOL ; IF SO, DECREMENT COLUMN 


C9BC:49 EE 




197 


EOR 


#SEE [DELETE? ($FF, RUB) 


C9BE:D0 09 




198 


BNE 


CTRLTST 


C9C0:DE B8 


DC 


199 DECRCOL 


DEC 


COLBYTE, X .-DECREMENT COLUMN COUNT 


C9C3.-I0 03 




200 


BPL 


ADJRTS 


C9C5:9D B8 


06 


201 


STA 


COLBYTE, X (DON'T ALLOW TO GO BELOW 


C9C8:60 




202 ADJRTS 


RTS 




C9C9:C9 CO 




203 CTRLTST 


CMP 


#$C0 [DON'T INCREMENT COLUMN CO 


C9CB:B0 FB 




204 


BCS 


ADJRTS [ CONTROL CHARACTERS 


C9CD:FE B8 


06 


205 


INC 


COLBYTE, X 


C9D0:60 




206 


RTS 




C9D1 : 




207 *************************** *************** 


C9D1 : 




208 * ROUTINE TO 


PROCESS SPECIAL INPUT CHARS * 


C9D1 : 










C9D1 : BD 38 


07 


210 CKINPUT 


LDA 


MISCFLG,X 


C9D4:29 08 




211 


AND 


#S08 (INPUT CTL CHARS ENABLED? 


C9D6:F0 16 




212 


BEQ 


CIEND 


C9D8: 




213 * 






C9D8:BD B8 


'■', 


214 


LDA 


STATEFLG, X 


C9DB:A4 27 




215 


LDY 


CHARACTER 


C9DD:C0 94 




216 


CPY 


#$94 ;CTL-T? 


C9DF:D0 04 




217 


BNE 


CKINPUT1 


C9E1 :09 80 




218 


ORA 


#$80 ;SET TERMINAL MODE 


C9E3:D0 06 




219 


BNE 


CKINPUT2 )<ALWAYS> 


C9E5( 




220 * 






C9E5:C0 92 




221 CKINPUT1 CPY #$92 ;CONTROL-R7 


C9E7:D0 05 




222 


BNE 


CIEND 


C9E9:29 7F 




223 


AND 


»$7F ,-RESET TERMINAL MODE 


C9EB:9D B8 


M 


224 CKINPUT2 STA STATEFLG, X 


C9EE:60 




225 CIEND 


RTS 




C9EF: 




226 « 







H 
H 

H 
?! 
H 
=1 

3 

a 

1 



C9EF: 

C9EF: 

C9EF: 

C9EF: 

C9EF: 

C9EF: 

C9EF : 

C9EK: 

C9EF: 

C9EF: 

C9EF : 

C9EF: 

C9EF: 

C9EF: 

C9EF:8A 

C9FO:0A 

C9F1 :0A 

C9F2:0A 

C9F3:0A 

C9F4:85 

C9F6:A9 

C9F8:9D 

C9FB:70 

C9FD: 

C9FD: AO 

C9FF:B1 

CA01 :85 

CAO3:20 

CA06:20 

CA09:90 

CA0B:60 

CAOC: 

CA0C:20 

CA0F:90 

CA1 1:B9 

CA14:A0 

CA16:91 

CA18:20 

CA1B:90 

CA1D:60 

CA1E: 

CA1E: 

CA1E: 

CA1E: 

CA1E: 

CA1E: 

CA1E:BD 

CA21:10 

CA23: 

CA23: 

CA2 3: 

CA23:A9 

CA25:48 

CA26:A9 

CA28:20 

CA2B: 

CA2B:A4 

CA2D:B1 



26 

00 

B8 05 
OF 

00 
3C 
27 

02 CC 
BA FC 
F2 



D2 CA 

FB 

88 CO 

00 

3C 

BA FC 

EF 



B8 04 

31 



7F 
E2 CD 



228 
1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 



•*****•*•***• 



CHN SSC.TERM 

•a****************************** 
* 

* APPLE II SSC FIRMWARE 

* BY LARRY KENYON 

* 

* -APRIL 1981- 

* * 

* (C) COPYRIGHT 1981 BY APPLE COMPUTER, INC. » 

* • 
ft**************************************** ***** 

* SHORT BLOCK MOVE « 
************************ 
BATCH 10 TXA 

ASL A 

ASL A 

ASL A 

ASL A 

STA SLOT1 6 

LDA #0 

STA STSBYTE, X ( ZERO ERROR INDICATION 

BVS MOVIN 
* 

MOVOUT LDY #0 

LDA (A1L),Y (GET BUFFER DATA 

STA CHARACTER 

JSR ACIAOUT ;SEND IT OUT THE ACIA 

JSR NXTA1 

BCC MOVOUT 

RTS 
* 

MOVIN JSR SRIN 

BCC MOVIN 

LDA RDREG.Y 

LDY #0 

STA (AIL),Y (PUT ACIA DATA INTO BUFFER 

JSR NXTA1 

BCC MOVIN 

RTS 
* 
•a******************************* 

* * 

* TERMINAL MODE ROUTINES * 

* * 
********************************* 

CHECKTERM LDA STATEFLG, X (HAVE WE ENTERED TERMINAL MODE? 
BPL TERMRTS (IF NOT, A SIMPLE RTS WILL DO. . . 

* 

* WE ENTER THE WORLD OF TERMINAL MODE 



TERMMODE LDA #S02 
PHA 

LDA #$7F 

JSR KCMD1 

* 

TERMNEXT LDY CH 

LDA (BASL),Y 



[START IN SHIFT-LOCK STATE 
(SHIFT STATE IS SAVED ON STACK 

[RESET ECHO (DEFAULT TO FULL DUP) 



70 SUPER SERIAL CARD 



S -t 



FIRMWARE 71 



CA2F:85 

CA31 :A9 

CA33:25 

CA35:DO 

CA37: A4 

CA39:A9 

CA3B:D1 

CA3D:D0 

CA3F:A5 

CA41 :91 

CA43:E6 

CA45: E6 

CA47: 

CA47: BD 

CA4A:30 

CA4C: 

CA4C : 20 

CA4F:68 

CA50:A9 

CA52:85 

CA54:60 

CA55: 

CA55:20 

CA58:90 

CA5A:20 

CA5D:20 

CA60:20 

CA63:4C 

CA66: 

CA66:20 

CA69:90 

CA6B:70 

CA6D: BD 

CA70:0A 

CA71 :10 

CA73:68 

CA74: A8 

CA75:A5 

CA77:C0 

CA79:F0 

CA7B:B0 

CA7D: 

CA7D:C9 

CA7P:D0 

CA81 : 

CA81 :C8 

CA82:98 

CA83:48 

CA84:4C 

CA87: 

CA87:C9 

CA89:90 

CA8B:C9 

CA8D: BO 

CA8F:09 

CA9I:85 

CA93: 

CA93:98 



27 
07 
4F 
10 
24 
DF 
28 
02 
27 
28 
4F 
4F 

B8 04 
09 

1 1 CC 

8D 
27 



FF CA 
OC 

11 CC 
D1 C9 
A3 CC 
2B CA 

3E CC 
C6 
BE 
38 07 



58 



STA CHARACTER ;SAVE SCREEN CHARACTER 



22 



27 
01 
20 
34 

9B 

in, 



2B CA 

C1 
08 
DB 
04 
20 
27 



59 TERMNEXT1 LDA «$07 

60 AND RNDH 

61 BNE TERMNEXT3 

62 LDY CH 

63 LOA #$DF 

64 CMP (BASL),Y 

65 BNE TERMNEXT2 

66 LDA 



IMPLEMENT A FLASHING UNDERLINE 
; FOR A CURSOR 



;IS UNDERLINE ON THE SCREEN? 
;IF NOT, PUT IT THERE 
CHARACTER .-OTHERWISE USE TRUE SCREEN CHAR 



67 TERMNEXT2 STA (BASL),Y 



INC 
INC 



RNDH 
RNDH 



68 
69 

70 
71 
72 

73 * 

74 TERMEXIT JSR RESTORE 

75 PLA 

76 LDA #S8D 

77 STA CHARACTER 

78 TERMRTS RTS 

79 • 

80 TERMACIAIN JSR INPUT 



;HAKE IT FLASH, BUT 

;N0T TOO SLOW AND NOT TOO FAST 



TERMNEXT3 LDA STATEFLG, X ;ARE WE STILL IN TERM MODE? 
BMI TERMACIAIN ;IF SO, GO CHECK ACIA 



j ALWAYS REPLACE OUR CURSOR 

; CLEAN UP THE STACK 

,- RETURN A <CR> TO COVER UP 



8CC 
JSR 
JSR 
JSR 

JMP 



TERMKBDIN 
RESTORE 
CK INPUT 
SCREENOUT1 
TERMNEXT 



TERMS END 1 



81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 * 

100 TERMNORM CMP #$9B 

101 BNE TERMLETTER 

102 * 

103 TERMINC INY 

104 TERMINC1 TYA 

1 05 PHA 

1 06 JMP TERMNEXT 

107 * 

108 TERMLETTER CMP »$C1 

109 BCC TERMS END 

110 CMP #SDB 

1 1 1 BCS TERMS END 

112 ORA #$20 

1 1 3 STA CHARACTER 

114 * 

1 15 TERMS END TYA 



;ACIA INPUT? 

;IP NOT, GO CHECK KEYBOARD 
; RESTORE CURSOR, INPUT->CHARACTER 
; CHECK FOR CTL-T, CTL-R 
;INPUT->SCREEN ALWAYS 



TERMKBDIN JSR GETK8D 

BCC TERMNEXT1 

BVS 

LDA 

ASL 

BPL 

PLA 

TAY 

LDA 

CPY 

BEQ 

BCS 



; KEYPRESS? 

jSKIP IF NOT 
TERMNEXT ; BRANCH IF WE DID A KBD ESCAPE SEO. 
MISCFLG, X jSHIFTING ENABLED? 



; RECOVER TERMSTATF. 



CHARACTER 
#1 

TERMCAP 
TERMLOCK 



j 1 = SHIFT LETTERS, XLATE NUMBERS 

;2 MEANS CAPS LOCK MODE 

;BSC? 

; INCREMENT STATE 
j PUT BACK ON STACK 

<A? 
>Z? 

IT'S A LETTER SO TRANSLATE TO LC 



H 

- 

H 
A 
'4 



CA94:43 




116 


PHA 




;PUT STATE BACK ON STACK 


CA95:20 


68 CB 


1 17 


TERMSEND1 JSR OUTPUT1 


;GO OUTPUT 


CA98:4C 


2B CA 


1 18 


JMP 


TERMNEXT 




CA9B: 




1 19 


* 






CA9B:C9 


9B 


120 


TERMCAP CMP 


»$9B 


;TWO ESCAPES? 


CA9D:F0 


E2 


121 


BEQ 


TERMINC 




CA9F : C9 


BO 


122 


CMP 


#$B0 


;<0? 


CAA1 :90 


OA 


123 


BCC 


TERMCAP1 




CAA3:C9 


BB 


124 


CMP 


#$BB 


; >COLON? 


CAA5:B0 


06 


125 


BCS 


TERMCAP 1 




CAA7: 




126 


* 






CAA7: 




127 


* ESC <NUMBER> SO TRANSLATE INTO MISSING ASCII 


CAA7: 




128 


* 






CAA7:A8 




129 


TAY 






CAA8 : B9 


09 CA 


130 


LDA 


TRANSLATE 


-$B0,Y 


CAAB:85 


27 


131 


STA 


CHARACTER 




CAAD:A0 


00 


132 


TERMCAP 1 LDY 


10 


;BACK TO STATE 


CAAF:F0 


E2 


1 33 


BEQ 


TERMS END 


;< ALWAYS) 


CAB1: 




134 


» 






CAB1 :C9 


9B 


135 


TERMLOCK CMP 


#$9B 


;ESC? 


CAB3:D0 


DE 


136 


BNE 


TERMS END 




CABS: AO 


00 


137 


LDY 


#0 




CAB7:F0 


C9 


138 


BEp 


TERMINC1 ; 


(ALWAYS) 


CAB9: 




139 


* 






CAB9: 




140 


a*************************** 


CAB9: 




141 


• TRANSLATE 


TABLE 


* 


CAB9: 




142 


##**•*»**»*#*#*»*#*»***»***# 


CAB9:9B 




143 


TRANSLATE DFB S9B 


,-ESC 


CABA:9C 




144 


DFB 


S9C 


;FS 


CABB:9F 




145 


DFB 


S9F 


(OS 


CABC:DB 




146 


DFB 


SDB 


;LEFT BRACKET 


CABD:DC 




147 


DFB 


$DC 


;LEFT SLASH 


CABE:DF 




148 


DFB 


$DF 


UNDERSCORE 


CABF:FB 




149 


DFB 


$FB 


;LEFT ENCLOSE 


CACO: FC 




150 


DFB 


$FC 


; VERTICAL BAR 


CAC1 : FD 




151 


DFB 


$FD 


(RIGHT ENCLOSE 


CAC2:FE 




152 


DFB 


SFE 


; TILDE 


CAC3:PF 




153 


DFB 


SFF 


;RUB 


CAC4: 




154 


# 






CAC4: 




155 


CHN 


SSC.CORE 





72 SUPER SERIAL CARD 



* 1 

6 i 



FIRMWARE 73 



CAC4 : 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4: 

CAC4:A2 

C AC6 : CA 

CAC7:D0 

CAC9:38 

CACA : E9 

CACC:DO 

CACE:AE 

CADI :60 

CAD2: 

CAD2: 

CAD2: 

CAD2: 

CAD2: 

CAD2: 

CAD2:A4 

CAD4:89 

CAD7:48 

CAD8:29 

CADA:4A 

CADB:4A 

CADC:85 

CADE: 68 

CADF.-29 

CAE1 :C9 

CAE3:90 

CAE5: 29 

CAE7:B0 

CAE9:A5 

CAEB:05 

CAED: FO 

CAEF:09 

CAF1 : 9D 

CAF4:60 

CAF5: 

CAF5: 

CAF5: 

CAF5:A4 



********************************* 



01 

F6 
F8 07 



26 

89 CO 



35 

OF 
08 
04 
07 
02 
35 
35 
05 
20 
B8 05 



* APPLE II SSC FIRMWARE 

* 

* BY LARRY KEN YON 

* -JANUARY 1981- 

* 
(C) COPYRIGHT 1981 BY APPLE COMPUTER, INC. * 



************** 



2 
3 

4 
5 
6 

7 

8 

9 

10 

11 * » 

12 ********************************************** 

13 * * 

14 * CORE SUBROUTINES * 

15 • * 

16 a*** ******* *********** *********** 

17 ********************************* 

18 • GENERAL PURPOSE WAIT ROUTINE » 

19 ********************************* 

20 * 

21 • WAITMS WAITS FOR [A-REG] MILLISECONDS (256 IF A-REG^O) 

22 * 

23 WAITMS 

24 WAITMS 1 
25 
26 
27 
28 
29 
30 

31 ************************************** 

32 * ACIA STATUS REGISTER READ ROUTINES * 

33 ************************************** 

34 * 
35 

36 * 

37 SRIN LDY SLOT1 6 
STREG, Y 



LDX 


#202 


DEX 




BNE 


WAITMS 1 


SEC 




SBC 


#01 


BNE 


WAITMS 


LDX 


MSLOT 


RTS 





;< DON'T LET THIS LOOP CROSS A PAGE> 
,-5 MICROSECOND LOOP 



SRIN USED TO CHECK ACIA INPUT STATUS 
;SLOT16-SN0 



LDY 
LDA 
PHA 
AND 
LSR 
LSR 
STA 
PLA 
AND 
CMP 
BCC 
AND 
BCS 
LDA 
ORA 
BEQ 
ORA 
STA 
RTS 



38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 

50 SRIN1 

51 SRIN2 
52 
53 
54 

55 SRIN3 

56 * 

57 » SROUT CHECKS IF TDR IS EMPTY + HARDWARE HANDSHAKE IS OK 

58 * 

59 SROUT LDY SLOT16 



#$20 

A 

A 

ZPTEMP 

#S0F 

#$08 

SRIN1 

#$07 

SRIN2 

ZPTEMP 

ZPTEMP 

SRIN3 

#$20 



jDCD? 

;AN ERROR IF NOT 



;SET CARRY IF RDR FULL, ELSE CLEAR 

iPE, FE, OVR VALID ONLY WHEN RDR=1 
j < ALWAYS) 



;GET DCD ERROR BIT 
; BRANCH IF NO ERRORS FOUND 
;ELSE SET BIT 5 TO OFFSET FOR PASCAL 
STSBYTE, X (AND SAVE IN STATUS TEMP 

(CY=1 MEANS DATA IS AVAILABLE 



M 

H 

H 

3 

"J 



CAF7:B9 

CAFA:29 

CAFC:C9 

CAFE:60 

CAFF: 

CAFF: 

CAFF: 

CAFF: 

CAFF: 20 

CB02-.90 

CB04: 

CB04:B9 

CB07:09 

CB09:C9 

CB0B:D0 

CBOD: 

CBOD: A8 

CB0E:BD 

CB1 1 : 29 

CB1 3:D0 

CB15:98 

CB16: 

CB16:38 

CB17:60 

CB18: 

CB18: 18 

CB19:60 

CB1A: 

CB1 A: 

CB1A: 

CB1 A: 

CB1 A: 

CB1A: 

CB1A: 

CB1A:A4 

CB1C:B9 

CB1F:4A 

CB20:BO 

CB22:BD 

CB25:29 

CB27:FO 

CB29:20 

CB2C:38 

CB2D:60 

CB2E: 

CB2E:A5 

CB30:29 

CB32:DD 

CB35:D0 

CB37:FE 

CB3A:38 

CB3B:60 

CB3C: 

CB3C : BD 

CB3F:29 

CB41 :FO 

CB43: 

CB43:20 



89 CO 

70 

10 



D2 CA 
15 

88 CO 
80 
8A 
09 



38 07 

20 

03 



26 

81 CO 

36 
B8 04 

07 
05 
FC CD 



27 

7F 

38 05 
05 
B8 04 



38 07 

08 

15 

FF CA 



LDA 


STREG, Y 


AND 


#S70 


CMP 


#$10 


RTS 





60 

61 
62 
63 

64 * 

65 ************************* 

66 • GENERAL INPUT ROUTINE * 
************************* 

JSR SRIN 
BCC 



;EQU IF TDR EMPTY, DCD, DSR, s CTS 



67 

68 INPUT 

69 BCC NOINPUT1 

70 • 

71 LDA RDREG.Y 

72 ORA #$80 

73 CMP #$8A 

74 BNE INPUT2 

75 * 

76 TAY 

77 LDA 

78 AND 

79 BNE 

80 TYA 

81 * 

82 INPUT2 SEC 

83 RTS 

84 * 

85 NOINPUT CLC 

86 NOINPUT1 RTS 

87 * 
************************* 

GENERAL OUTPUT ROUTINE • 
************************** 



[GET THE ACIA INPUT 
/SET HI BIT FOR BASIC 
;LINEFEED? 



MISCFLG.X J SEE IF WE SHOULD EAT IT 

#$20 

NOINPUT ;IF SO, JUST KEEP IT A SECRET 



(INDICATE DATA 



; CARRY CLEAR FOR NO INPUT 



* START OF COMMAND CHECK ROUTINE 



88 
89 
90 
91 
92 

93 * 

94 CMDSEQCK LDY SLOT16 

95 LDA 

96 LSR 

97 BCS 

98 LDA 

99 AND 

1 00 BEQ 

101 JSR 

102 SEC 

103 RTS 

104 • 

105 ESCCHECK LDA CHARACTER 
AND #S7F 
CMP 
BNE 
INC 
SEC 
RTS 



DIPSW1 ,Y 

A 

NOCMD 

STATEFLG, X 

#$07 

ESCCHECK 

CMDPROC 



.•DON'T WORRY ABOUT CMD SEQ FOR SIC 

(ARE WE IN A COMMAND SEQUENCE? 

(IF SO, GOTO COMMAND CENTRAL 
(INDICATE COMMAND 



106 
107 
108 
109 
110 
111 

112 • 

1 1 3 XOFFCK LDA 

1 14 AND 

1 1 5 BEQ 
1 16 * 

1 1 7 JSR 



(IGNORE HIGH BIT 
CMDBYTE, X [IS THIS BEGINNING OF A CMD SEQ? 
XOFFCK 
STATEFLG, X (START UP COMMAND MODES 

(INDICATE COMMAND 



MISCFLG.X ,-IS XON ENABLED? 

#$08 

NOCMD /SKIP THIS IF NOT 



INPUT 



(ANY INPUT? 



S ^ 



74 SUPER SERIAL CARD 



FIRMWARE 75 



CB46:90 

CB48:C9 

CB4A:F0 

CB4C:48 

CB4D: BD 

CB50:4A 

CB51 :4A 

CB52:68 

CBS 3: 90 

CB55:9D 

CB58:18 

CB59:60 

CB5A: 

CB5A:20 

CB5D:C9 

CB5F:D0 

CB61 : 18 

CB62:60 

CB63: 

CB63: 

CB63: 

CB63:20 

CB66:B0 

CB68: 

CB68: 20 

CB6B: 

CB6B: A4 

CB6D:B9 

CB70:4A 

CB71 :90 

CB73:4A 

CB74:90 

CB76: 

CB76: 

CB76: 

CB76: 

CB76: 

CB76: 

CB76: 

CB76: 

CB76: 

CB76:A5 

CB78:48 

CB79:BD 

CB7C:C9 

CB7E:90 

CB80:C9 

CB82:B0 

CB84:C9 

CB86:68 

CB87:48 

CB88:49 

CB8A:29 

CB8C:D0 

CB8E:B0 

CB90: 

CB90:BD 

CB93:29 



10 
93 

0E 

38 07 



04 
B8 06 



AA C8 

91 

F9 



1A CB 
F1 



26 

81 CO 



118 
119 
120 
121 
122 
123 
124 
125 
126 
127 

128 NOCMD 

1 29 ANRTS 

130 * 

131 XONWAIT JSR 
CMP 
BNE 
CLC 
RTS 



27 

38 04 

67 

10 

6C 

22 

6B 



9B 

7P 
18 
19 

B8 04 

IF 



BCC 
CMP 
BEQ 
PHA 
LDA 
LSR 
LSR 
PLA 
BCC 
STA 
CLC 
RTS 



132 
133 
134 

135 



NOCMD ;IF NOT, GO OUTPUT 

#$93 ,- IS IT AN XOFF? 

XONWAIT ;IF SO, GO WAIT FOR ANOTHER INPUT 

MISCFLG.X ;CIC MODE? 
A 



ANRTS 

BUFBYTE, X ; IF SO, WE HAVE A BUFFER 
; INDICATE NOT A CMD SEO 



GETCHAR ;GET ACIA/KBD DATA 
#$91 ;IS IT AN XON? 

XONWAIT ;IF NOT, WAIT 

OTHERWISE, INDICATE NOT A CMD SEQ 

,- AND RETURN 



136 ************************************************** 

137 « NOW THE OUTPUT ROUTINE YOU'VE BEEN WAITING FOR * 

1 3a **•*****************#**********************»****** 

1 39 OUTPUT JSR CMDSEQCK 



140 

141 * 

142 OUTPUT1 JSR 

143 * 

144 OUTPUT2 LDY 



BCS ANRTS 



;DON'T OUTPUT COMMAND SEQUENCES 



LDA 
LSR 
BCC 
LSR 
BCC 



SCREENOUT 

SLOT1 6 
DIPSW1, Y 
A 

OUTPUT3 
A 
OUTPUT 3 



I SKIP ETX/ACK FOR NATIVE MODES 
; BRANCH IF NOT P8A EMULATION 



145 
146 
147 
148 
149 

150 • 

151 ******************** 

152 * PSA ETX/ACK STUFF* 

153 ******************** 

154 * AFTER 148 CHARACTERS BUT NOT WITHIN AN ESCAPE SEQUENCE 

OF UP TO 5 CHARACTERS, THE HANDSHAKE IS PERFORMED 

(WILL DELAY UNTIL 'NOT ESC AND THEN 4 MORE CHARS 

OR UNTIL AN ' ESC ' ) 



155 
156 
157 

158 * 

159 P8A0UT1 
160 

161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 

173 • 

174 ETX 
175 



LDA 
PHA 
LDA 
CMP 
BCC 
CMP 
BCS 
CMP 
PLA 
PHA 
EOR 
AND 
BNE 
BCS 

LDA 

AND 



CHARACTER ;SAVE CHAR ON STACK 



HANDS HKE.X ;CHAR COUNT FOR BUFFER FULL 

#103 ;IF <103 THEN 153 CHARS IN BUFFER 

ETX 

#108 ) IF >=108 THEN LESS THAN 149 CHARS 

P8A0UT2 i SO NO HANDSHAKE IS NEEDED YET 

#107 ;SETS CARRY IF 107 (149 SENT) 



#$9B ;ESC? 

#$7F ; IGNORE HI-BIT 

P8AOUT2 ; COUNT AS 1 OF 5 IF NOT 'ESC 

P8AOUT3 ; DON'T COUNT IF 149TH CHAR IS 

STATEFLG.X f SEND QUERY CHAR TO PRINTER 
#$1F .-(DEFAULT IS ETX) 









CB95:09 

CB97:85 

CB99: 20 

CB9C:20 

CB9F:49 

CBA1 :D0 

OBA3:9D 

CBA6: 

CBA6:DE 

CBA9:68 

CBAA:85 

CBAC:49 

CBAE:0A 

CBAF:D0 

CBB1 :BD 

CBB4:29 

CBB6:F0 

CBB8: 9D 

CBBB: 

CBBB:20 

CBBE:4C 

CBC1 : 

CBC1 : 

CBCI : 

CBC1 : 20 

CBC4: 

CBC4: 

CBC4: 

CBC4:0A 

CBC5: A8 

CBC6:BD 

CBC9:C0 

CBCB:F0 

CBCD: 4 A 

CBCE:4A 

CBCF:C0 

CBD1 :F0 

CBD3:4A 

CBD4:4A 

CBD5:C0 

CBD7:D0 

CBD9-.29 

CBDB:F0 

CBDD: AB 

CBDE:B9 

CBE1 ! A8 

CBE2:A9 

CBE4: 20 

CBE7:88 

CBE8:D0 

CBEA: 

CBEA: 

CBEA: 

CBEA:A5 

CBEC:0A 

CBED:C9 

CBEF:D0 

CBF1 : BD 



80 
27 

02 CC 
AA C8 
86 
ED 
38 04 

38 04 

27 

8D 

OA 

B8 03 
30 
03 
38 04 

02 CC 

EA CB 



02 CC 



B8 03 

18 

OC 



14 
06 



1A 

25 
03 

on 



20 
C4 CA 



P8 



27 



1A 
OD 
38 07 



176 

177 

178 

179 ACK 

180 

181 

182 

183 * 

134 P8A0UT2 DEC 

185 P8A0UT3 PLA 



ORA 
STA 
JSR 
JSR 

EOR 
BNE 
STA 



186 
187 
188 
189 
190 
191 
192 
193 

194 * 

195 P8A0UT4 JSR 

196 JMP 



STA 
EOR 
ASL 
BNE 
LDA 
AND 
BEQ 
STA 



#S80 

CHARACTER 

ACIAOUT 

GETCHAR ;GET ACIA/KBD DATA 

#S86 ;ACK? 

ETX ;IF NOT ACK, REPEAT HANDSHAKE 

HANDS HKE.X ;INIT CHAR COUNT TO 255 

HANDS HKE.X 

jGET REAL CHAR TO OUTPUT 
CHARACTER 

#$8D ;IF CR AND CR DELAY MODE 

A 

P8AOUT4 ; THEN FAKE CHAR COUNT TO LESS THAN 
DELAYFLG, X ; 48 TO FORCE HANDSHAKE ON NEXT 
#$30 ; CHARACTER OUT 

P8A0UT4 
HANDS HKE.X 



; (SKIP DELAYS) 



ACIAOUT 
LFGEN 

197 ***************************** 

198 * AND BACK TO NORMAL OUTPUT * 

199 ***************************** 

200 OUTPUT3 JSR ACIAOUT ; OUTPUT THE CHARACTER 

201 « 
NOW CHECK FOR CR, LF, AND FF DELAYS 



202 

203 * 

204 

205 

206 

207 

208 

209 

210 

211 

212 

213 

214 

215 

216 

217 OUTDLY1 

218 

219 

220 



ASL 
TAY 
LDA 
CPY 
BEQ 
LSR 
LSR 
CPY 
BEQ 
LSR 
LSR 
CPY 
BNE 
AND 
BEQ 
TAY 
LDA 



DELAYFLG, X ,-GET DELAY FLAGS 



#$18 

OUTDLYl 

A 

A 

#$14 

OUTDLYl 

A 

A 

#$1A 

OUTPUTEND 

#$03 

LFGEN 



.-FORM FEED? 



; RIGHT JUSTIFY LF DELAY 
;LINE FEED? 



.-RIGHT JUSTIFY CR DELAY 
.-CARRIAGE RETURN? 



;JUST WANT LOWEST 2 BITS 
;NO DELAY INDICATED 



DLYTBL-1 , Y 

221 TAY /DELAY IN 32 MSEC INCREMENTS 

222 OUTDLYLP LDA #32 ; 

223 JSR WAITMS 

224 DEY 

225 BNE OUTDLYLP 

226 * 

227 » CHECK ON LF GENERATION OPTION 

228 * 
CHARACTER 
A 

#$1A /CARRIAGE RETURN? 

OUTPUTEND 
MISCFLG.X [IS LF GENERATE ENABLED? 



229 LFGEN 

230 

231 

232 

233 



LDA 
ASL 
CMP 
BNE 
LDA 



76 SUPER SERIAL CARD 






FIRMWARE 77 



T 



CBF4:6A 

CBF5:90 07 

CBF7:A9 8A 

CBF9:85 27 

CBFB:4C 6B CB 

CBFE:60 

CBFF: 

CBFF:01 

CC00:08 

CC01:40 

CCO 2: 

CCO 2: 

CCO 2: 

CC02:20 F5 CA 

CC05:D0 FB 

CC07:98 

CC08:09 89 

CCOA : A8 

CC0B:A5 27 

CC0D:99 FF BF 

CC10:60 

CC1 1 : 

CC11: 

CC11 1 

CC11: 

CC11: 

CC11 : 48 

CC12:A4 24 

CC14-.A5 27 

CC16:91 28 

CC18:68 

CC19: 

CC19:C9 95 

CC1B:D0 OC 

CC1D:A5 27 

CC1F:C9 20 

CC21 :B0 06 

CC23: 20 DF CC 

CC26:59 DB CC 

CC29:85 27 

CC2B:60 

CC2C: 

CC2C: 



234 
235 
236 
237 
238 



ROR 
BCC 
LDA 
STA 
JMP 



OUTPUTEND 

»S8A 

CHARACTER ;LINE FEED 

0UTPUT2 ; (DON'T ECHO IT) 



239 OUTPUTEND RTS 

240 * 

241 DLYTBL DFB $01 ;32 MSEC 

242 DFB $08 ,1/4 SEC 

243 DFB $40 ; 2 SEC 

244 ************************** 

245 * ACIA OUTPUT ROUTINE • 

246 ************************** 



247 ACIAOUT JSR 
BNE 
TVA 
ORA 
TAY 
LDA 
STA 
RTS 



248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 



SROUT 
ACIAOUT 

#$89 

CHARACTER 
$BFFF,Y 



j READY FOR OUTPUT? 



; PREPARE TO ADDRESS ACIA, 
,- CAUSING 6502 FALSE READ TO OCCUR 
I ON PAGE $BF (AVOIDING RDR READ) 
,-HERE YOU ARE ACIA 



«««»*••*•••«****•**«•**«***«******* 

* RESTORE CURSOR (NOT FOR PASCAL) * 

* (A-REG SHOULD CONTAIN NEW CHAR) « 

*********************************** 



260 RESTORE PHA 

261 LDY 

262 LDA 

263 STA 

264 PLA 

265 * 

266 CMP 

267 BNE 

268 LDA 

269 CMP 

270 BCS 

271 JSR 

272 EOR 

273 RESTOREND STA CHARACTER 

274 RTS 

275 * 

276 CHN SSC.UTIL 



;SAVE NEW CHARACTER 



CH 

CHARACTER ;OLD CHARACTER 

(BASL),Y 



#$95 

RESTOREND 

CHARACTER 

#$20 

RESTOREND 

GETXLATE 

REVMASK, Y 



; SCREEN PICK? 

;IF SO, USE SCREEN CHAR 
[INVERSE? 

j REVERSE THE TRANSLATION 



= a 

s 

si 

H 

a 

■4 






m 






CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C: 

CC2C:18 

CC2D! BD 

CC30:29 

CC32:F0 

CC34: 

CC3':AD 

CC37:10 

CC39:8D 

CC3C.-38 

CC3D:60 

CC3E: 

CC3E: 

CC3E: 

CC3E:E6 

CC40:D0 

CC42:E6 

CC44:20 

CC47.-B8 

CC48:90 

CC4A:20 

CC4D:29 

CC4F:DD 

CCS 2: DO 

CC54:A4 

CC56:B9 

CC59:4A 

CC5A:B0 

CC5C: 

CC5C: 

CC5C: 

CC5C:A0 

CC5E.-B9 

CC61 :85 

CC63:98 

CC64:48 

CC65:20 

CC68:68 

CC69:A8 

CC6A:88 

CC6B:10 

CC6D: 



38 07 

04 

09 

00 CO 
04 
10 CO 



4E 
02 
4F 
2C CC 

F3 

11 CC 

7F 

38 05 

3D 

26 

81 CO 



35 



OA 

93 CC 
27 



************** 



2 
3 
4 

5 
6 

7 

8 

9 

10 

11 * « 

12 a********************************************* 

13 * * 

14 « UTILITY ROUTINES • 

15 * * 

16 ********************************* 

17 * PASCAL-BASIC KEYBOARD FETCH * 
******************************* 



APPLE II SSC FIRMWARE 
BY LARRY KENYON 

-JANUARY 1981- 

* 
(C) COPYRIGHT 1981 BY APPLE COMPUTER, INC. * 



18 

19 CKKBD 

20 

21 
22 

23 * 

24 CKKBD1 
25 
26 

27 SEC 

28 CKKBDXIT RTS 

29 a******************************************* 

30 • GET A CHAR FROM KEYBOARD FOR BASIC ONLY * 

31 ******************************************** 



CLC 




LDA 


MISCFLG, X 


AND 


#S04 


BEQ 


CKKBDXIT 


LDA 


KBD 


BPL 


CKKBDXIT 


STA 


KBDSTRB 



; RETURN CARRY CLEAR FOR NO DATA 

; ANSWER NO IF KEYBOARD IS DISABLED 



[INDICATE DATA 



32 GETKBD INC 

33 BNE 

34 INC 

35 GETKBD1 JSR 



RNDL 
GETKBD 1 
RNDH 
CKKBD 



;MIX UP RANDOM • SEED 
; FOR BASIC 



; KEYBOARD FETCH ROUTINE 

; INDICATE NO ESCAPE SEQUENCE 

;EXIT IF NO KEY PRESS 

;DO BASIC CURSED DUTY 



36 CLV 

37 BCC CKKBDXIT 

38 JSR RESTORE 

39 AND #$7F 

40 CMP CMDBYTE, X I IS IT THE START OF A COMMAND? 

41 BNE GETKBDONE ; IF NOT, EXIT INDICATING DATA 

42 LDY SLOT 16 

43 LDA DIPSW1.Y /ONLY DO CMD ESC FOR PPC, SIC MODES 

44 LSR A 

45 BCS GETKBDONE 

46 *************************** 

47 * KEYBOARD ESCAPE HANDLER * 

48 *************************** 

49 KBDESC LDY #$A ;FIRST PRINT A PROMPT 

50 PROMPTLOOP LDA PROMPTBL, Y 

51 STA CHARACTER 



52 
53 
54 
55 
56 
57 
58 
59 



TYA 
PHA 
JSR 
PLA 
TAY 
DEY 
BPL 



SCREENOUT1 ; ALWAYS SEND TO SCREEN 



PROMPTLOOP 



78 SUPER SERIAL CARD 



FIRMWARE 79 



T 



CC6D:A9 01 
CC6F:20 7B CE 
CC72: 

CC72:20 34 CC 
CC75: 10 FB 
CC77:C9 88 
CC79:F0 El 
CC7B:85 27 
CC7D: 

CC7D:20 A3 CC 
CC80:20 1A CB 
CC83: 

CC83: BD B8 04 
CC86:29 07 
CC88:D0 E8 
CC8A: 

CC8A:A9 8D 

CC8C:85 27 

CC8E: 2C 58 PF 

CC91 : 38 

CC92:60 

CC93: 

CC93: 

CC93:BA C3 D3 

CC96:D3 A0 C5 

CC99:CC DO DO 

CC9C:C1 

CC9D:8D 

CC9E: 

CC9E: 

CC9E: 

CC9E: 

CC9E:BD 38 07 

CCA1:10 13 

CCA3: 

CCA3:BD 38 07 

CCA6:29 02 

CCAB:F0 OD 

CCAA:BD B8 04 

CCAD: 29 38 

CCAF:FO 06 

CCB1 : 

CCB1 :8A 

CCB2:48 

CCB3:A9 AF 

CCB5:48 

CCB6:60 

CCB7: 

CCB7: 

CCB7: 

CCB7:20 DF CC 

CCBA:09 80 

CCBC:C9 EO 

CCBE:90 06 

CCC0:59 D3 CC 

CCC3:4C F6 FD 

CCC6: 

CCC6: 



• 1 
SETOSTATE 

CKKBD1 

GETCMD 

#388 

KBDESC 

CHARACTER 



; START OUT IN COMMAND STATE 1 



;WAIT FOR KEYBOARD CHARACTER 



BACKSPACE? 

(IF SO, THEN START OVER 



SCREEN0UT1 

CMDSEOCK j PUMP THRU CMD INTERPRETER 



60 LDA 

61 JSR 

62 * 

63 GETCMD JSR 

64 BPL 

65 CMP 

66 BEQ 

67 STA 

68 * 

69 JSR 

70 JSR 

71 * 

72 LDA 

73 AND 

74 BNE 

75 • 

76 LDA 

77 STA 

78 BIT 

79 GETKBDONE SEC 

80 RTS 

81 * 

82 * 

83 PROMPTBL ASC ":CSS ELPPA" 



84 DFB S8D 

85 * 

96 A***********************************************'****** 

87 * ROUTINE TO PRINT A CHARACTER ON THE CURRENT DISPLAY * 
gg ********»**•*****#********•********» 

89 SCREENOUT LDA MISCFLG, X 

90 BPL NOOUT ;IF SCREEN DISABLED 

91 * 

92 SCREEN0UT1 LDA MISCFLG, X ; ENTRY AFTER ECHO CHECK 



STATEFLG, X 

#307 

GETCMD 

#S8D 

CHARACTER 

IORTS 



;ARE WE DONE? 

I IF NOT, GO AGAIN 

; FORCE BACK A CARRIAGE RETURN 

; INDICATE THAT A CMD SEQ HAS OCCURRED 
,- INDICATE SUCCESS 



**»*#*******#*****#* 



93 AND 

94 BEQ 

95 LDA 

96 AND 

97 BEQ 

98 * 

99 TXA 

1 00 PHA 

101 LDA 

1 02 PHA 

103 NOOUT RTS 

104 * 

105 * APPLE 40-COL SCREEN DRIVER 

106 * 



#$02 ;IF IT ISN'T CIC MODE, 

ASCREEN ,-ALWAYS USE THE APPLE SCREEN 

STATEFLG, X ,-CURRENT SCREEN = APPLE SCREEN? 

#$38 

ASCREEN ;SLOT 0" APPLE SCREEN 



(JUMP TO CNOO SPACE 

#>SENDCD-1 ; TO VECTOR TO THE PERIPHERAL 
,- IN THE CHAIN SLOT 



GETXLATE ;GET THE TRANSLATE OPTIONS 

#S80 ;SET HIGH BIT OF CHAR 

#$E0 ; LOWERCASE? 

TESTLETTER 

LCMASK.Y ;DO LOWERCASE TRIP 

;ALL REGS ARE PRESERVED 



107 ASCREEN JSR 

108 ORA 

109 CMP 

110 BCC 

111 EOR 

112 TOSCREEN JMP VIDOUT 

113 • 

114 * IF UPPERCASE, WE ONLY MAP LETTERS 



# j 


I ^ 














tf j 


j H 


CCC6: 
CCC6 : C9 


CI 




1 15 * 

116 TESTLETTER CMP #$C1 ; <A7 








CCC8:90 


F9 




117 BCC 


TOSCREEN 




* j 


j 3 


CCCA:C9 


DB 




1 1 8 CMP 


#SDB ;>Z? 




CCCC:B0 


F5 




119 BCS 


TOSCREEN 








CCCE:59 


D7 


CC 


120 EOR 


UCMASK, Y 




m j 


i H 


CCD1 :90 

CCD3: 

CCD3: 


i-'O 




121 BCC 

122 * 

123 * MASKS FOR 


TOSCREEN ;<ALWAYS> 
CASE TRANSLATION 




t I 


i H 


CCD3:20 
CCD6:20 


00 


EO 


124 LCMASK DFB 


$2O,$OO,SE0,$2O 




* 


j H 


CCD7:00 
CCDA:C0 
CCDB:00 


00 
DO 


00 

EO 


125 UCMASK DFB 

1 26 REVMASK DFB 


$0O,S0O,$00,$C0 
$00,$00,$EO,$CO 




* 


3 


CCDE:C0 
CCDF: 
CCDF : BD 


BS 


03 


127 « 

1 28 GETXLATE LDA 


DELAYFLG, X ,-TRANSLATE OPTIONS IN B6-B7 


m 


j =* 


CCE2:2A 
CCE3:2A 
CCE4:2A 






1 29 ROL 

1 30 ROL 

1 3 1 ROL 


A 
A 
A 




m 


: =i 


CCE5:29 

CCE7:A8 


3 




132 AND 

1 33 TAY 


#$03 








CCE8:A5 


27 




1 34 LDA 


CHARACTER 




m 


: -i 


CCEA:60 
CCEB: 






1 35 RTS 
136 * 






m 


1 4 


(listiti 


8« 


continued on next 


page) 




E 


: ^ 














■ 


I ^ 














m 


i a 














* 


1 * 














■ 


H 














* 


3 














* 


4 














m 


H 














m 


H 














fii 


A 















80 SUPER SERIAL CARD 



£ 4 



FIRMWARE 81 



CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 

CCEB: 42 

CCEC:67 

CCED:CO 

CCEE:54 

CCEF:47 

CCP0:A6 

CCF1 :43 

CCF2:87 

CCF3:A6 

CCF4:51 

CCF5:47 

CCF6 : B8 

CCF7:5 2 

CCF8:C7 

CCF9 : AC 

CCFA:5A 

CCFB:E7 

CCFC:F3 

CCFD:49 

CCFE:90 

CCFF:D3 

CD00:4B 

CD01 :90 

CD02:DF 

CD03: 

CD03:45 

CD04:43 

CD05:80 

CD06:46 

CD07:E3 

CD08:04 

CD09:4C 

CD0A:E3 

CD0B:01 

CDOC:58 

CDOD: E3 

CD0E:08 

CDOF:54 

CD10:83 



138 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 



CHN SSC.CMD 

******************************** 



APPLE II SSC FIRMWARE 
BY LARRY KENYON 



-JANUARY 1981- 



************* 



* (C) COPYRIGHT 1981 BY APPLE COMPUTER, INC. • 

* * 

•A****************************** 

* SSC COMMAND PROCESSOR 

* 

••a****************************** 

********************************* 

* COMMAND TABLE (USED BY COMMAND PROCESSER ROUTINE * 

**************************************************** 



...».*.»...»*..»••* 



19 CMDTBL 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 * 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 



DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 

DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 



S42 
$67 



,-B(REAK) 
;CIC PAS 



>BREAKCMD-1 



S54 
S47 

>TERMCMD-1 

S43 

$87 

>TERMCMD-1 



jT(ERMINAL) 
;CIC 

;C(R GENERATE) 



NS=7 



$51 
$47 
>QUITCMD-1 



$52 
SC7 

>RESETCMD-1 



PPC 

;Q(1JIT) 
;CIC 
I 
;R(ESET) 
;CIC PPC 



$5A 

$E7 

>ZCMD-1 

$49 

$90 

>ICMD-1 

$4B 

$90 

>KCMD-1 

$45 
$43 
$80 
$46 
$E3 
$04 
$4C 
$E3 
$01 
$58 
$E3 
$08 
$54 
$83 



;Z COMMAND 
;CIC PPC PAS 



;I 

; 



COMMAND 
PPC 



|K COMMAND 
: PPC 



;E(CHO) 
;CIC 

;F(ROMKYBD) 
;CIC PPC PAS 



NS-3 



;L(F GENERATE) 
|CIC PPC PAS NS-3 

jX(OFF) 

;CIC PPC PAS NS=3 

;T(ABBING) 

; PPC NS=3 



■ 



B 



m * 



CDl 1 :40 




58 




DFB 


S40 






CD1 2:53 




59 




DFB 


$53 


;S(HIFTING) 




CDl 3:43 




60 




DFB 


$43 


;CIC 


NS-3 


CDl 4: 40 




61 




DFB 


$40 






CD15:4D 




62 




DFB 


$4D 


;M(UNCH LF) 




CD16:E3 




63 




DFB 


$E3 


;CIC PPC PAS 


NS-3 


CD17:20 




64 




DFB 


$20 






CD18: 




65 


* 










CD18:00 




66 




DFB 


$00 


;END OF FIRST 


PART 


CD19: 




67 


• 










CD19:42 




68 


CMDTBL 1 


DFB 


$42 


;B(AUD) 




CD1A:F6 




69 




DFB 


$F6 


;CIC PPC PAS 


NS-6 


CD1B:7C 




70 




DFB 


>BAUDCMD-1 






CD1C:50 




71 




DFB 


$50 


.-P(ARITY) 




CD1D:F6 




72 




DFB 


$F6 


;CIC PPC PAS 


NS-6 


CD1E:9A 




73 




DFB 


>PARITYCMC 


-1 




CD1F:44 




74 




DFB 


$44 


,-D(ATA) 




CD20:F6 




75 




DFB 


$F6 


iCIC PPC PAS 


NS=6 


CD21 :9B 




76 




DFB 


>DATACMD-1 






CD22:46 




77 




DFB 


$46 


(F(F DELAY) 




CD23:F6 




78 




DFB 


$F6 


iCIC PPC PAS 


NS=6 


CD24:46 




79 




DFB 


>FFCMD-1 






CD25:4C 




80 




DFB 


$4C 


)L(F DELAY) 




CD26:F6 




81 




DFB 


$F6 


[CIC PPC PAS 


NS-6 


CD27:40 




82 




DFB 


> LFCMD- 1 






CD28:43 




83 




DFB 


$4 3 


;C(R DELAY) 




CD29:F6 




84 




DFB 


$F6 


;CIC PPC PAS 


NS=6 


CD2A:3A 




85 




DFB 


>CRCMD-1 






CD2B:54 




86 




DFB 


S54 


;T(RANSLATE) 




CD2C:D6 




87 




DFB 


SD6 


(CIC PPC 


NS-6 


CD2D: 34 




88 




DFB 


>TRANCMD-1 






CD2E:4E 




89 




DFB 


$4E 


,-N COMMAND 




CD2F:90 




90 




DFB 


$90 


PPC 


NS=0 


CD30: E8 




91 




DFB 


>NCMD-1 






CD31 :53 




92 




DFB 


$53 


;S(CREENSLOT) 




CD32:56 




93 




DFB 


$56 


;CIC 


NS=6 


CD33:60 




94 




DFB 


>SSLOTCMD- 


1 




CD34: 




95 


* 










CD34:00 




96 




DFB 


$00 


;END OF TABLE 


MARK 


CD35: 
CD35: 
CD35: 




97 
98 
99 


* 




********** 
UTINES * 






w** 4 ft 4 « - * nit** 

* COMMAND RO 




CD35: 




100 


* (CALLED BY 


PARSER) * 






CD35: 




101 


» (MUST 


START IN « 






CD35: 




102 


* PAGF 


$CD 


■ • • ) * 






CD35: 




103 


********************** 






CD35: A9 


3F 


104 


TRANCMD 


LDA 


»$3F 


;SET SCREEN T 


RANSL 


CD37:A0 


07 


105 




LDY 


*$7 






CD39:D0 


10 


106 




BNE 


DELAYS ET 


;<ALWAYS> 




CD3B:A9 


CF 


107 


CRCMD 


LDA 


#$CF 


;SET CR DELAY 




CD 3D: AO 


05 


108 




LDY 


#$5 






CD3F:D0 


OA 


109 




BNE 


DELAYS ET 


;<ALWAYS> 




CD41 : 




110 


* 










CD41 :A9 


F3 


1 1 1 


LFCMD 


LDA 


#$F3 


;SET LF DELAY 




CD43:A0 


03 


112 




LDY 


#S3 






CD45:DO 


04 


1 13 




BNE 


DELAYS ET 


;<ALWAYS> 




CD47: 




114 


* 










CD47:A9 


FC 


1 15 


FFCMD 


LDA 


#$FC 


;SET FF DELAY 





82 SUPER SERIAL CARD 



4 



FIRMWARE 83 




CD49:A0 01 
CD4B:3D B8 03 
CD4E:85 2A 
CD50:BD 38 04 
CD53:29 03 
CD55: 18 
CD56:6A 
CD57:2A 
CD58:88 
CD59:D0 FC 
CD5B: 

CD5B:05 2A 
CD5D:9D B8 03 
CD60:60 
CD61 : 

CD61:29 07 
CD63:0A 
CD64:0A 
CD65:0A 
CD66:85 2A 
CD68:0A 
CD69:C5 26 
CD6B:F0 OF 
CD6D:BD B8 04 
CD70:29 C7 
CD72:05 2A 
CD74:9D B8 04 
CD77:A9 00 
CD79:9D 38 06 
CD7C:60 
CD7D: 

CD7D: 29 OF 
CD7F:D0 07 
CD81 :B9 81 CO 
CD84:4A 
CD85:4A 
CD86:4A 
CD87:4A 
CD88:09 10 
CD8A:85 2A 
CD8C:A9 EO 
CD8E:85 2B 
CD90: B9 8B CO 
CD93:25 2B 
CD95:05 2A 
CD97:99 8B CO 
CD9A:60 
CD9B: 
CD9B:88 
CD9C: 
CD9C: 
CD9C : OA 
CD9D: OA 
CD9E:0A 
CD9F : OA 
CDAO:0A 
CDA1:85 2A 
CDA3:A9 IF 



116 LDY #S1 

117 DELAYSET AND DELAYFLG.X ;DON' 

118 STA ZPTMP1 



T DISTURB THE OTHER FLAGS 



LDA 
AND 
CLC 
ROR 
ROL 
DEY 
BNE 



PARAMETER, X 



#S03 



ROTATE 



ZPTMP1 
DELAYFLG, X 



SSLOTCMD AND #S7 
ASL A 



ASL 
ASL 
STA 
ASL 
CMP 
BEQ 
LDA 
AND 
ORA 
STA 
LDA 
STA 
SSL0TCMD1 RTS 



119 

120 

121 

122 

123 ROTATE 

124 

125 

126 • 

1 27 ORA 

1 28 STA 

1 29 RTS 

130 * 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 

146 * 

147 BAUDCMD AND #SOF 

1 48 BNE BAUDCMD2 

149 BAUDCMD1 LDA DIPSW1,Y 

150 LSR A 

151 LSR A 

152 LSR A 

153 LSR A 

154 BAUDCMD2 ORA »S10 

155 STA ZPTMP1 

156 LDA #$E0 

157 CTLREGSET STA ZPTMP2 

158 LDA CTLREG.Y 

159 AND ZPTMP2 

160 ORA ZPTMP1 

161 STA CTLREG.Y 

162 RTS 

163 * 

164 PARITYCMD DEY 

165 * 

166 * 

167 DATACMD ASL A 

1 68 ASL A 

1 69 ASL A 

170 ASL A 

171 ASL A 

172 DATACMD1 STA ZPTMP1 

173 LDA #S1F 



,-JUST USE TOO BITS 



;ONCE FOR FUN 
(CHANGE DIRECTIONS 



I PREPARE IT TO OR INTO THE FLAGS 



;SET SLOT COMMAND 



A 

A 

ZPTMP1 

A 

SL0T16 ;MAKE SURE WE DON'T SET IT 

SSLOTCMD1 ; TO OUR OWN SLOT 

STATEFLG, X 

#$C7 ;PUT NEW SLOT NUMBER IN BITS 3-5 

ZPTMP1 ( OF CMDBYTE, X 

STATEFLG, X 

#0 ; STORE ZERO INTO 

CHNBYTE, X ;SL0T OFFSET (SET TO CNOO ENTRY) 



;SET NEW BAUD RATE 

;ZERO PARM = RELOAD FROM SWITCHES 

;SET INT. BAUD RATE GENERATOR 



■ 



(TRICK: SO CTLREG.Y ACTUALLY 
ADDRESSES THE COMMAND REG 



(SET NEW » OF DATA BITS 



V 



3 
=1 



CDA5:D0 

CDA7: 

CDA7: IE 

CDAA:38 

CDAB:B0 

CDAD: 

CDAD:99 

CDB0.-20 

CDB3:20 

CDB6: AE 

CDB9: 1 E 

CDBC:18 

CDBD: 7E 

CDC0:60 

CDC1 : 

CDC1 :B9 

CDC4:48 

CDC5:09 

CDC 7: 99 

CDCA:A9 

CDCC:20 

CDCF:68 

CDD0:99 

CDD3:60 

CDD4: 

CDD4:A9 

CDD6:9D 

CDD9: A9 

CDDB: ID 

CODE: DO 

CDEO: 

CDEO : A9 

CDE2: 3D 

CDE5:9D 

CDE8:60 

CDE9: 

CDE9:C9 

CDEB:90 

CDED:9D 

CDF0:A9 

CDF 2: DO 

CDF 4: 

CDF4: 1 E 

CDF7:38 

CDF8: 7E 

CDFB:60 

CDFC: 

CDFC: 

CDFC: 

CDFC: 

CDFC : AS 

CDFD:A5 

CDFF:29 

CE01 : 

CE01 :C9 

CEO3:D0 

CEO5:C0 

CE07:FO 



B8 04 

10 

89 CO 
93 FE 
89 FE 
F8 07 
B8 04 

B8 04 



8A CO 

OC 

8A CO 
E9 

C4 CA 

8A CO 



28 

38 06 
80 

38 07 
05 

FE 

38 07 
38 07 



28 

OE 

38 06 
3F 
EE 

38 05 

38 05 



n 

7F 

20 
09 
03 

01 



174 BNE 

175 * 

176 TERMCMD ASL 

177 SEC 

178 BCS 

179 * 

180 RESETCMD STA RESET, Y 

181 JSR SETSCR 

182 JSR 

183 LDX 

184 OUITCMD ASL 

185 CLC 

186 OCMD1 ROR 

187 RTS 

188 * 

189 BREAKCMD LDA CMDREG,Y 



CTLREGSET ;<ALWAYS> 

STATEFLG, X ;SET TERMINAL MODE 

OCMD1 



,-<ALWAYS> 

j DROP RTS, 
(PR#0 
; IN#0 



DTK 



SETKBD 

MSLOT 

STATEFLG, X ;CLEAR TERMINAL MODE 

STATEFLG, X 



190 
191 
192 
193 
194 
195 
196 
197 

198 * 

199 ICMD 
200 
201 
202 
203 

204 * 

205 KCMD LDA 

206 KCMD1 AND 

207 KCMD2 STA 

208 RTS 

209 * 

210 NCMD CMP 
BCC 
STA 
LDA 
BNE 



PHA 
ORA 
STA 
LDA 
JSR 
PLA 
STA 
RTS 

LDA 
STA 
LDA 
ORA 
BNE 



#S0C 

CMDREG, Y 
#233 
WAITMS 

CMDREG, Y 



(SEND BREAK SIGNAL 
; FOR 233 MILLISECONDS 



(DELAY FOR 233 MICROSEC. 



(RESTORE OLD COMMAND REG CONTENTS 



#S28 

PWDBYTE, X (SET PRINTER WIDTH TO 40 

#$80 

MISCFLG, X (SET SCREEN ECHO 



KCMD2 

#$FE 

MISCFLG, X 
MISCFLG, X 



(<ALWAYS> 



(RESET THE LF GENERATE FLAG 



040 

ZCMDRTS 
PWDBYTE, X 
»S3F 
KCMD1 



(>=40? 
(IF NOT, 



211 
212 
213 
214 

215 * 

216 ZCMD ASL 

217 SEC 

218 ROR 

219 ZCMDRTS RTS 

220 * 

221 ' " * ************ . ft****************** , 

222 * VECTOR ACCORDING TO COMMAND STATE « 

223 **•*****************#**■**********•*** 



JUST EXIT 
(SET NEW PRINTER WIDTH 
(DISABLE SCREEN, SET LISTING MODE 
( <ALWAYS> 



CMDBYTE, X (DISABLE COMMAND RECOGNITION 
CMDBYTE, X 



224 CMDPROC TAY 

225 LDA 

226 AND 

227 * 

228 CMP 

229 BNE 

230 CPY 

231 BEQ 



;A-REG=COMMAND STATE 



CHARACTER 
#S7F 

#$20 
CMDPROC 2 

#S3 
CMDPROC 1 



(SKIP SPACES FOR ALL MODES 



(EXCEPT MODE 3 



84 SUPER SERIAL CARD 



£ -* 



FIRMWARE 85 



CEOS: 60 

CE0A:A9 

CEOC:DO 

CBOEi 

CEOE:C9 

CE10:DO 

CE12: 20 

CE15:C0 

CE17:F0 

CE19:60 

CE1A: 

CE1A:A9 

CE1C:48 

CE1D:BD 

CE20:48 

CE21 :A4 

CE23:60 

CE24: 

CE24:85 

CE26:A9 

CE28:48 

CE29:B9 

CE2C:48 

CE2D:A5 

CE2F:60 

CE30: 

CE30: 

CE30 

CE30 

CE30 

CE30 

CE30 

CE31 

CE32:6I 

CE33:89 

CE34:8A 

CE35:A7 

CE36:89 

CE37:89 

CE38: 

CE38: 

CE38: 

CE38:DD 

CE3B:D0 

CE3D:DE 

CE40:4C 

CE43: 

CE43:C9 

CE45:90 

CE47:C9 

CE49:B0 

CE4B:29 

CE4D: 9D 

CE50: A9 

CE52:DO 

CE54: 

CE54:C9 

CE56:B0 



#S07 
CMDPR0C3 



232 RTS 

04 233 CMDPROCI LDA »$4 

6D 234 BNE SETOSTATE ,-<ALWAVS> 

235 • 
OD 236 CMDPR0C2 CMP »$0D 

12 237 BNE 

79 CE 238 JSR 

07 239 CPY 

01 240 BEQ 

241 RTS 

242 • 
CD 243 CMDPR0C3 LDA #$CD 

244 PHA 

38 04 245 LDA PARAMETER, X 

246 PHA 

26 247 LDY SL0T1 6 

248 RTS 

249 * 
35 250 CMDPR0C4 STA ZPTEMP 
CE 251 LDA 

PHA 
30 CE 253 LDA 

PHA 
35 255 LDA 

RTS 



j CARRIAGE RETURN? 
CMDPR0C4 ; 
ZEROSTATE ; ABORT FOR STATES 0-5, EXIT FOR 6,7 



;IN STATE 7 WE VECTOR TO THE PROC 
I 
OTHERWISE, JUST EXIT 

(ALL PROCS MUST START IN PAGE $CD 



; NEEDED BV BREAK CMD 



38 05 
06 

B8 04 
02 CC 

30 

OD 

3A 

09 

OF 

38 04 

02 

27 

20 
06 



#SCE 
STATETBL, Y 
ZPTEMP 



[ALL ROUTINES MUST START 
; IN PAGE SCE 



;RTS TO COMMAND PROCEDURE 



251 
252 
253 
254 
255 
256 

257 * 

258 * NOW THE STATE ROUTINES 

259 • 

260 *********************** 

261 * STATE BRANCH TABLE * 

262 A********************** 

263 STATETBL DFB >STATERR-1 

264 DFB >CSTATE1-1 

265 DFB 

266 DFB 

267 DFB 

268 DFB 

269 DFB 

270 DFB 

271 ******************* 

272 * COMMAND STATE 1 » 

273 ******************* 

274 CSTATE1 CMP CMDBYTE, X (IS IT <CMD>7 
CSTATE1 A 

STATEFLG,X ;SET STATE BACK TO ZERO 
ACIAOUT (OUTPUT <CMD> IF SO 



;BAD STATE 

;<CMD> SEEN 
>CSTATE2-1 (ACCUMULATE PARAMETER 
>CD0NE-1 (SKIP UNTIL SPACE 
>CSTATE4-1 (E/D SOMETHING 
>STATERR-1 (ILLEGAL STATE 
>CD0NE-1 (SKIP UNTIL CR 
>CDONE-l (SKIP UNTIL CR THEN DO CMD 



275 
276 
277 

278 * 

279 CSTATE1A CMP #S30 



BNE 
DEC 
JMP 



280 BCC 

281 CMP 

282 BCS 

283 AND 

284 STA 

285 LDA 

286 BNE 

287 * 

288 CSTATE1B CMP #$20 

289 BCS CSTATE1C 



(>-0? 
(<-97 

[IT'S 



CSTATE1 B 

»S3A 

CSTATE1 B 

#S0F [IT'S A NUMBER 

PARAMETER, X 

#2 

SETOSTATE [<ALWAYS> SET MODE 2 AND RETURN 

(IS IT A CONTROL CHAR? 



86 SUPER SERIAL CARD 



* 


^ 


ff 1 


H 


§ 


H 


■ 


H 


• 


-* 


• 


3 


m 


«< 


l! 


H 


■ 


1 * 


m 


j 4 


m 


4 


m 


: 3 


m 


i ^ 


m 


: ^ 


* 


I ^ 


■ 


| H 


■ 


« 


* 


4 


• 


4 


m 


H 


m 


'A 


m 


-1 


s 


4 


?= 


-1 



CE58:9D 

CE5B:4C 

CE5E: 

CE5E:A0 

CE60:F0 

CE62: 

CE62: 

CE62: 

CE62:49 

CE64:C9 

CE66:B0 

CE68: AO 

CE6A:7D 

CE6D:88 

CE6E:D0 

CE70:9D 

CE73:F0 

CE75: 

CE75sA0 

CE77:D0 

CE79: 

CE79: 

CE79: 

CE79:A9 

CE7B:85 

CE7D: AE 

CE80:BD 

CE83:29 

CE85:05 

CE87:9D 

CE8A:60 

CE8B: 

CE8B: 

CE8B: 

CE8B:A8 

CE8C:BD 

CE8F:C0 

CE91 :F0 

CE93:C0 

CE95:D0 

CE97: ID 

CE9A:D0 

CE9C:49 

CE9E:3D 

CEA1 :9D 

CEA4: 

CEA4: 

CEA4: 

CEA4:A9 

CEA6:D0 

CEA8: A9 

CEAA:9D 

CEAD:D0 

CEAF: 

CEAF: 

CEAF: 

CEAF:B9 

CEB2:F0 



38 05 
79 CE 



00 

40 



30 
OA 
OD 
OA 
38 04 

FA 

38 04 
15 

2E 
36 



00 
2A 

F8 07 
B8 04 
F8 
2A 
B8 04 



38 04 

44 

09 

45 

11 

38 07 

05 

FF 

38 07 

38 07 



06 
D3 
20 



PS 



EB CC 
F4 



290 

291 

292 

293 

294 

295 

296 

297 

298 

299 

300 

301 

302 

303 

304 

305 

306 

307 

308 

309 

310 

311 

312 

313 

314 

315 

316 

317 

318 

319 

320 

321 

322 

323 

324 

325 

326 

327 

328 

329 

330 

331 

332 

333 

334 

335 

336 

337 

338 

339 

340 

341 

342 

343 

344 

345 

346 

347 



STA CMDBYTE, X [SET NEW COMMAND CHARACTER 
JMP ZEROSTATE [RESET STATE TO ZERO 

* 

CSTATE1C LDY #0 [USE COMMAND TABLE 

BEQ CMDSEARCH [<ALWAYS> 

••*• A************************************ 

* COMMAND STATE 2: ACCUMULATE PARAMETER « 



(CONVERT S30-S39 TO 0-9 
1 0-9? 



CSTATE2 EOR #S30 

CMP »SA 

BCS CSTATE2A 

LDY #$A [IT'S A NUMBER, SO ADD 

ACCLOOP ADC PARAMETER, X [ IT TO 10*PARAMETER 

DEY 

BNE ACCLOOP 

STA PARAMETER, X 

BEQ CDONE (<ALWAYS> 

* 

CSTATE2A LDY KCMDTBL1-CMDTBL (USE COMMAND TABLE 

BNE CMDSEARCH |<ALWAYS> 

********************* 

• SET COMMAND STATE • 
********************* 
ZEROSTATE LDA #0 
SETOSTATE STA ZPTMP1 

LDX MS LOT 

LDA STATEFLG, X 

AND #SF8 

ORA ZPTMP1 

STA STATEFLG, X 
CDONE RTS 
************************* 

« COMMAND STATE 4 (E/D) • 

•a*********************** 

CSTATE4 TAY 

LDA 

CPY 

BEQ 

CPY 

BNE 

ORA 

BNE 
CSTATE4A EOR #SFF 

AND MISCFLG.X 
CSTATE4B STA MISCFLG.X 
********************* 

» ESCAPE TO STATE 6 * 
********************* 

SETSTATE6 LDA #6 

BNE SETOSTATE (<ALWAYS> 
STATERR LDA »32 

STA STSBYTE, X 

BNE SETSTATE6 [<ALWAYS> 

* TABLE DRIVEN COMMAND PROCESSOR • 

********************************** 



[E/D -> Y-REG 
PARAMETER, X 



HS44 

CSTATE4A 

#345 

STATERR 

MISCFLG.X 

CSTATE4B 



(D(ISABLE)? 

(E(NABLE)? 

[IF NOT, IGNORE THIS COMMAND 

[SET FLAG 

I <ALWAYS> 

[ INVERT FOR DISABLE 

[RESET FLAG 



,-CODE FOR BAD COMMAND 



CMDSEARCH LDA CMDTBL, Y (GET CANDIDATE CHARACTER 

BEQ STATERR (A ZERO MARKS THE END OF A SUBTABLE 
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1 



35 

05 



CEB4:C5 

CEB6:F0 

CEB8:C8 

CEB9:C8 

CEBA:C8 

C EBB: DO 

CEBD: 

CEBD:C8 

CEBE:B9 

CEC1 :85 

CEC3:29 

CECSiDO 

CEC7:BD 

CECA:29 

CECC:DO 

CECE: 

CECE:BD 

CBD1 :4A 

CED2:4A 

CED3: 24 

CED5:B0 

CED7: 10 

CED9:30 

CEDB:50 

CEDD: 

CEDD: A5 

CEDF:48 

CEE0:29 

CEE2:20 

CEE5:C8 

CEE6:68 

CEE7:29 

CEE9:D0 

CEEB:B9 

CEEE:9D 

CEF1 :60 

CEF2: 

CEP2: A9 

CEP4:48 

CEF5: B9 

CEF8:48 

CEF9: A4 

CEFB:BD 

CEFE:60 

CEFF: 

CEFF:00 



SYMBOL TABLE 



348 CMP 

349 BEO 

350 INY 
35' CMDSEARCH1 INY 

352 INY 

353 BNE 

354 * 

355 CMDMATCH INY 



ZPTEMP 
CMDMATCH 



; MATCH? 



EB CC 
2A 

20 
07 

38 07 
10 
EB 

38 07 



2A 

04 
EO 

02 
DC 



07 

7B CE 



10 
07 

EB CC 
38 04 



CD 

EB CC 



26 

38 04 



; REENTRY FOR WRONG MODES 
; ENTRY LENGTH - 3 
CMDSEARCH j<ALWAYS> 






CMDTBL, Y 

ZPTMP1 

#S20 ;CHECK PASCAL ENABLE 

CMDMATCH1 ;IT'S ON SO DONT CHECK P-BIT 

MISCFLG.X ;OFF SO MAKE SURE 

KS10 ; THAT WE AREN'T IN PASCAL 

CMDSEARCH! ; BRANCH IF WE ARE 



356 LDA 

357 STA 

358 AND 

359 BNE 

360 LDA 

361 AND 

362 BNE 

363 * 

364 CMDMATCH1 LDA MISCFLG.X ;GET CIC/PPC BIT 

365 LSR A /SHIFT CIC/PPC MODE BIT TO CARRY 

366 LSR A 

367 BIT ZPTMP1 ;PPC->N CIC->V 

368 BCS CMDMATCH2 /BRANCH IF CIC MODE 

369 BPL CMDSEARCH 1 ,-NOT OK FOR PPC 

370 BMI CMDEXEC ;AND OK 

371 CMDMATCH2 BVC CMDSEARCH1 ;NOT OK FOR CIC 

372 * 
ZPTMP1 ; RETRIEVE TABLE MODE BYTE 



37 3 CMDEXEC LDA 



374 PHA 

375 AND 

376 JSR 

377 INY 

378 PLA 

379 AND 

380 BNE 

381 LDA 

382 STA 

383 RTS 

384 * 

385 CMDEXEC1 LDA HSCD 



#$07 

SETOSTATE ;SET NEXT STATE 



- 



KS10 

CMDEXEC! 
CMDTBL, Y 
PARAMETER, X 



;IF BIT 4 IS SET, VECTOR TO ROUTINE 



; ROUTINES MUST BE IN PAGE SCD 



386 
387 
388 
389 
390 
391 
392 
393 



PHA 
LDA 
PHA 
LDY 
LDA 
RTS 



CMDTBL, Y 



SLOT1 6 

PARAMETER, X .-LOT OF ROUTINES NEED THIS 



DFB S00 



SORTED BY SYMBOL 



3C 


AIL 


C9C8 


ADJRTS 


C8B8 


BASICEXIT 


7C941 


BATCHOUT 


C71 1 


BENTRY 


C8D0 


BIN END 


C8BF 


BINPUT 


CDC1 


BREAKCMD 


27 


CHARACTER 


C9EE 


CI END 



CE6A 


ACCLOOP 


CCO 2 


ACIAOUT 


C9B5 


ADJUST 


CB59 


ANRTS 


28 


BASL 


7C93D 


BATCHIN 


CD7D 


BAUDCMD 


CD81 


BAUDCMD1 


C8EF 


BINACIA1 


C8EA 


BINACIA 


C745 


BINIT1 


7C700 


BINIT 


C77C 


BOUTPUT1 


C767 


BOUTPUT 


06B8 


BUFBYTE 


CE8A 


CDONE 


CA1E 


CHECKTERM 


0638 


CHNBYTE 


C9D1 


CKINPUT 


C9E5 


CKINPUT1 



7C89C 


ACK 


CCB7 


ASCREEN 


C9EF 


BATCH 10 


CD88 


BAUDCMD2 


C8E5 


BINEND1 


C8CB 


BINKBD 


C78B 


BOUTPUT2 


24 


CH 


C8B5 


CICEXIT 


C9EB 


CKINPUT2 



* ! 
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CC3D 
CEF2 
CEDB 
CE24 
CEB9 
06B8 
CE43 
CE75 
CE8B 
C08E 
C9C0 
C082 
CD47 
C8B4 
CC44 
CDD4 
C827 
C857 
C882 
FF58 
CDE2 
38 
0738 
CDE9 
CCB6 
FCBA 
CB68 
CBFE 
OBBB 
7C89E 
C99B 
CC93 
C7AB 
CDBD 
CDAD 
CCDB 
CDS 7 
C7B0 
C996 
CEA4 
CAD2 
CD61 
CE30 
C948 
CAAD 
CA82 
CAB1 
CA41 
CA93 
CD35 
CAC4 
CDFB 
2A 



CKKBDXIT 

CMDEXEC1 

CMDMATCH2 

CMDPROC4 

CMDSEARCH 1 

COLBYTE 

CSTATE1A 

C STATE 2A 

CSTATE4 

CTLREGSET 

DECRCOL 

DIPSW2 

FKCMD 

GETCHAR1 

GETKBD1 

ICMD 

INIT1A 

INIT3 

INITACIA1 

IORTS 

KCMD1 

KSWL 

MISCFLG 

NCMD 

NOOUT 

NXTA1 

OUTPUT 1 

OUTPUTEND 

P8AOUT4 

PASCALREAD1 

PENTRY 

PROMPTBL 

PSTATUS2 

CCMD1 

RESETCMD 

REVMASK 

ROTATE 

SENDCD 

S ETCH 

SETSTATE6 

SRIN 

SSLOTCMD 

STATETBL 

TAB2 

TERMCAP1 

TERMINC1 

TERMLOCK 

TERMNBXT2 

TERMS END 

TRANCMD 

WAITMS 

ZCMDRTS 

ZPTMP1 



CC2C 
CEDD 
CEOA 
CDFC 
CB1A 
C917 
CE54 
CE62 

37 
C9C9 
03B8 
CBFF 
C968 
C8AA 
CC91 
C705 
C835 
C864 
C88F 
C010 
CDE5 
CCD3 
CAOC 
CB58 
C75C 
C707 
C86B 
7CB76 
0438 
C89B 
C78E 
CC5E 
0638 
CDB9 
CCI1 

4F 
C7B2 
C998 
FE89 

26 
CAF4 
0100 
C089 
C921 
CA9B 
CA81 
7CA23 
CA47 
CA95 
CAB9 
CAC6 
CDF4 

2B 



CKKBD 

CMDEXEC 

CMDPROC1 

CMDPROC 

CMDSEOCK 

COMMA 

CSTATE1 B 

CSTATE2 

CSWH 

CTRLTST 

DELAYFLG 

DLYTBL 

FORCECR 

GETCHAR 

GETKBDONE 

I ENTRY 

INIT2 

INIT4 

INITACIA2 

KBDSTRB 

KCMD2 

LCMASK 

MOVIN 

NOCMD 

NORM 10 

OENTRY 

OUTPUT2 

P8AOUT1 

PARAMETER 

PASCALREAD 

PINIT 

PROMPTLOOP 

PWDBYTE 

QUITCMD 

RESTORE 

RNDH 

SAVEHOOK 

SEREND2 

SETKBD 

SLOT16 

SRIN3 

STACK 

STREG 

TABCHECK 

TERMCAP 

TERM INC 

TERMMODE 

TERMNEXT3 

TERMS END1 

TRANSLATE 

WAITMS1 

ZCMD 

ZPTMP2 



SYMBOL TABLE 

24 CH 

2A ZPTMP1 

37 CSWH 

4E RNDL 

03B8 DELAYFLG 



SORTED BY ADDRESS 

26 SLOT16 

2B ZPTMP2 

38 KSWL 

4F RNDH 

0438 HANDSHKE 



CC34 
CECE 
CEOE 
C08A 
CD19 
FDED 
CE5E 
CE9C 
36 
CDA1 
CD4B 
CB2E 
C754 
CC72 
CCDF 
0200 
C83C 
C872 
CB16 
C000 
CDEO 
CD41 
C9FD 
CB19 
C954 
CBD9 
CB63 
CBA6 
CD9B 
C9AA 

7C84D 
C7A8 
C9A6 
C088 
CC29 
4E 
CC9E 
C97A 
CE7B 
CAE9 
CAF5 
04B8 
05B8 

7C088 
CDA7 
CA66 
CA2B 

7CA7D 
CCC6 
CCD7 
CB3C 
CE79 



CKKBD1 

CMDMATCH1 

CMDPROC2 

CMDREG 

CMDTBL1 

COUT 

CSTATE1C 

CSTATE4A 

CSWL 

DATACMD1 

DELAYS ET 

ESCCHECK 

FROM IN 

GETCMD 

GETXLATE 

INBUFF 

INIT2A 

INIT5 

INPUT2 

KBO 

KCMD 

LFCMD 

MOVOUT 

NOINPUT1 

NOTAB1 

OUTDLY1 

OUTPUT 

P8AOUT2 

PARITYCMD 

PASCALWRITB 

PREADO 

PSTATIN 

PWDTBL 

RDREG 

RESTOREND 

RNDL 

SCREENOUT 

3EREND 

SETOSTATE 

SRIN1 

SROUT 

STATEFLG 

STSBYTE 

TDREG 

TERMCMD 

TERMKBDIN 

TERMNEXT 

TERMNORM 

TESTLBTTER 

UCMASK 

XOFFCK 

ZEROSTATE 



27 CHARACTER 
35 ZPTEMP 
39 KSWH 

0100 STACK 

0438 PARAMETER 



0538 
CEBD 
CE1A 
CEAF 
CCEB 
CD3B 
CE38 
CEA1 
C08B 
CD9C 
C081 
CB90 
C751 
CC3E 
0438 
C805 
C83F 

7C879 
CAFF 
CC5C 
39 
CBEA 
07F8 
CB18 
C951 
CBE2 
CBC1 
CBA9 
C800 
C8A3 
C794 
C79A 
C797 
C089 
C7EE 
CFFF 
CCA 3 
CRFC 

' 
CAEB 
CD7C 
CEA8 
C934 
CA55 

7CA4C 
CA87 
CA31 
CA54 
CCC3 
FDF6 
CB5A 
35 



CMDBYTE 

CMDMATCH 

CMDPROC 3 

CMDSEARCH 

CMDTBL 

CRCMD 

CSTATE1 

CSTATE4B 

CTLREG 

DATACMD 

DIPSW1 

ETX 

FROMOUT 

GETKBD 

HANDSHKE 

INIT1 

INIT2B 

INITACIA 

INPUT 

KBDESC 

KSWH 

LFGEN 

MSLOT 

NOINPUT 

NOTAB 

OUTDLYLP 

OUTPUT3 

P8AOUT3 

PASCAL INIT 

PASBXIT 

PREAD 

PSTATUS 

PWRITE 

RESET 

RESTORHOOK 

ROMSOFF 

SCREENOUT1 

SEROUT 

SETSCR 

SRIN2 

SSLOTCMD1 

STATERR 

TAB1 

TERMACIAIN 

TERMEXIT 

TERMLETTER 

TERMNEXT1 

TERMRTS 

TOSCREEN 

VIDOUT 

XONWAIT 

ZPTEMP 



28 BASL 

36 CSWL 

3C AIL 
0200 INBUFF 
04B8 STATEFLG 
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0538 


CMD8YTE 


05B8 


STSBYTE 


0638 


PWDBYTE 


0638 


CHNBYTE 


06B8 


C0LBYTE 


06B8 


BUFBYTE 


0738 


MISCFLG 


07P8 


MS LOT 


COOO 


KBD 


C010 


KBDSTRB 


C081 


DIPSW 1 


C082 


DIPSW2 


7C088 


TDREG 


C088 


RDREG 


C089 


STREG 


C089 


RESET 


C08A 


CMDREG 


C08B 


CTLREG 


7C700 


BINIT 


C705 


I ENTRY 


C707 


GENTRY 


C71 1 


BENTRY 


C745 


BINIT1 


C75I 


FROMOUT 


C7S4 


FROMIN 


C75C 


NORM 10 


C767 


BOUTPUT 


C77C 


B0UTPUT1 


C78B 


B0UTPUT2 


C78E 


PINIT 


0794 


PR BAD 


C797 


PWRITE 


C79A 


PSTATUS 


C7A8 


PSTATIN 


C7AB 


PSTATUS 2 


C7B0 


SENDCD 


C7B2 


SAVEHOOK 


C7EE 


RESTORHOOK 


C800 


PASCAL INIT 


C805 


INIT1 


C827 


INIT1A 


C835 


INIT2 


08 30 


INIT2A 


C83F 


INIT2B 


7C84D 


PRE ADO 


C857 


INIT3 


0864 


INIT4 


C872 


INIT5 


7C879 


INITACIA 


C882 


INITACIA1 


C88F 


INITACIA2 


C89B 


PASCALREAD 


7C89E 


PASCALREADI 


C8A3 


PASEXIT 


C8AA 


GETCHAR 


C8B4 


GETCHAR1 


C8B5 


CICEXIT 


C8B8 


BASICEXIT 


C8BF 


BINPUT 


C8CB 


BINKBD 


C8D0 


BINEND 


C8E5 


BINEND1 


C8EA 


BINACIA 


C8EF 


BINACIA1 


C8FC 


SEROUT 


C917 


COMMA 


0921 


TABCHECK 


C934 


TAB1 


7C93D 


BATCH IN 


7C941 


BATCHOUT 


C948 


TAB2 


C951 


NOTAB 


C954 


N0TAB1 


C968 


FORCECR 


C97A 


SEREND 


C996 


SETCH 


0998 


SEREND2 


C99B 


PENTRY 


C9A6 


PWDTBL 


C9AA 


PASCALWRITE 


C9B5 


ADJUST 


C9C0 


DECRCOL 


C9C8 


ADJRTS 


C9C9 


CTRLTST 


C9D1 


CKINPUT 


C9E5 


CKINP0T1 


C9EB 


CKINPUT2 


09 EE 


CI END 


C9EF 


BATCH IO 


C9FD 


MOVOUT 


CAOC 


MOVIN 


CA1E 


CHECKTERM 


7CA2 3 


TERMMODE 


CA2B 


TERMNEXT 


CA31 


TERMNEXT1 


CA41 


TERMNEXT2 


CA47 


TERMNEXT3 


7CA4C 


TERMEXIT 


CA54 


TERMRTS 


CA55 


TERMACIAIN 


CA66 


TERMKBDIN 


7CA7D 


TERMNORM 


CA81 


TERMINC 


CAB 2 


TERMINCi 


CA87 


TERMLETTER 


CA93 


TERMS END 


CA95 


TERMS END1 


CA9B 


TERMCAP 


CAAD 


TERMCAPI 


CAB1 


TERMLOCK 


CAB9 


TRANSLATE 


CAC4 


WAITMS 


CAC6 


WAITMS1 


CAD2 


SRIN 


CAE9 


SRIN1 


CAEB 


SRIN2 


CAF4 


SRIN3 


CAF5 


SROUT 


CAFF 


INPUT 


CB16 


INPUT2 


CB18 


NOINPUT 


CB19 


N0INPUT1 


CB1A 


CMDSEQCK 


CB2E 


ESCCHECK 


CB3C 


X0FFCK 


CBS 8 


NOCMD 


CB59 


ANRTS 


CB5A 


XONWAIT 


CB63 


OUTPUT 


CB68 


OUTPUT 1 


CB6B 


0UTPUT2 


7CB76 


P8A0UT1 


CB90 


ETX 


7CB9C 


ACK 


CBA6 


P8AOUT2 


CBA9 


P8AOUT3 


CBBB 


P8AOUT4 


CBC1 


0UTPUT3 


CBD9 


0UTDLY1 


CBE2 


OUTDLYLP 


CBEA 


LFGEN 


CBFE 


OUTPUTEND 


CBFF 


DLYTBL 


CC02 


ACIAOIJT 


CC1 1 


RESTORE 


CC29 


RESTOREND 


CC2C 


CKKBD 


CC34 


CKKBD1 


CC3D 


CKKBDXIT 


CC3E 


GETKBD 


CC44 


GETKBD 1 


CCSC 


KBDESC 


CC5E 


PROMPTLOOP 


CC72 


GETCMD 


CC91 


GETKBDONE 


CC93 


PROMPTBL 


CC9E 


SCREENOUT 


CCA 3 


SCREENOUT 1 


CCB6 


NOOUT 


CCB7 


ASCREEN 


CCC3 


TOSCREEN 


CCC6 


TESTLETTER 


COD 3 


LCMASK 


CCD7 


UCMASK 


CCDB 


REVMASK 


CCDF 


GETXLATE 


CCEB 


CMDTBL 


CD19 


CMDTBL1 


CD35 


TRANCMD 


CD3B 


CRCMD 


CD41 


LFCMD 


CD47 


FFCMD 


CD4B 


DELAYSET 


CD57 


ROTATE 


CD61 


SSLOTCMD 


CD7C 


SSLOTCMD 1 


CD7D 


BAUDCHD 


CD81 


BAUDCMD1 


CD88 


BAUDCMD2 


CD8E 


CTLREGSET 


CD9B 


PARITYCMD 


CD9C 


DATACMD 


CDA1 


DATACMD1 


CDA7 


TERMCMD 


CDAD 


RESETCMD 


CDB9 


QUITO MD 


CDBD 


0CMD1 


CDC1 


BREAKCMD 


CDD4 


ICMD 


CDEO 


KCMD 


CDE2 


KCMDI 


CDE5 


KCMD2 


C0E9 


NCMD 


CDP4 


ZCMD 


CDFB 


ZCMDRTS 


CDFC 


CMDPROC 


CEO A 


CMDPR0C1 


CEOE 


CMDPR0C2 


CE1A 


CMDPRCC3 


CE24 


CMDPR0C4 


CE30 


STATETBL 


CE38 


CSTATEI 


CE43 


CSTATEI A 


CE54 


CSTATEI B 


CE5E 


CSTATE1C 


CE62 


CSTATE2 


CE6A 


ACCLOOP 


CE75 


CSTATE2A 


CE79 


ZEROSTATE 


CE7B 


SETOSTATE 


CE8A 


CDONE 


CE8B 


CSTATE4 


CE9C 


CSTATE4A 


CEA1 


CSTATE4B 


CEA4 


SETSTATE6 


CEA8 


STATERR 


CEAF 


CMDS EARCH 


CEB9 


CMDS EARCH 1 


CEBD 


CMDMATCH 


CEOE 


CMDMATCH1 


CEDB 


CMDMATCH2 


CEDD 


CMDEXEC 


CEF2 


CMDEXEC1 


CFFF 


ROMSOFF 


FCBA 


NXTA1 


FDED 


COUT 


FDF6 


VIDOUT 


FE89 


SETKBD 


FE93 


SETSCR 


FF58 


IORTS 
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The SSC emulates both the P8 and the P8A versions of the Apple II 
Serial Interface Card (SIC), although the SSC is not completely 
POKE-corapatible with either. In addition, the SSC supports several 
Apple II Communications Card and Parallel Card software commands. 



OLD SERIAL INTERFACE CARD EMULATION 

The SSC replaces the P8 and P8A versions of the Apple II Serial 
Interface Card (SIC) and it has two switch-selectable modes to 
emulate them, as explained below. However, because of firmware 
space limitations, the SSC does not support all functions of the 
older interface cards, and various POKE locations are different. 
This section explains these functional differences. 

It is best to use Printer Mode rather than one of the emulation 
modes, except under these circumstances: 

• if you have extensive existent applications that use PEEKs 
and POKEs to modify SIC operating characteristics 

• if you need SIC P8A mode's ETX/ACK (or other-character/ ACK) 
handshaking capabilities 

What the SSC does NOT support that the old SIC does: 

• P8 SIC block moves 

• baud rates other than the 15 listed lp the various baud rate 
tables in this manual (ACIA hardware generates only those 15) 

• data formats other than 5-8 data bits and 1, 1-1/2 or 2 stop 
bits (ACIA characteristic; other formats rarely used anyway) 

• <ESOU and <ESC>L commands for upper and lowercase (but SSC's 
Translate command offers more options; POKEs also available) 

• current-loop operation 
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To run the SSC in emulation of the old Apple II Serial Interface 
Card (SIC), prepare and install the SSC the same way as for Printer 
Mode (Chapters 1 and 2), with the following exceptions: 

• Set mode switches SW1-5 ON and SW1-6 OFF to emulate the old 
SIC with a P8 ROM. 

• Set mode switches SW1-5 OFF and SW1-6 OFF to emulate the old 
SIC with a P8A ROM. 

• Install the SSC in whatever slot the old SIC was installed in 
for the application involved. 

• Follow the instructions given in the next sections if the 
application program did PEEKs and POKEs. 

P8 EMULATION POKES 

Changing SIC parameters was done either by setting the seven switches 
located on the card, or by POKEing the SIC slot RAM locations where 
this configuration data was stored. BASIC programs that talked 
through the old SIC may be used with the new SSC; however, if the 
program POKEs at these slot RAM locations, those POKEs must be 
changed to be compatible with the SSC's use of the RAM. The P8 and 
P8A ROMs differ slightly in their use of these RAM locations. 
Tables B-l and B-2 show the transformation for P8 mode; additional 
differences for P8A mode are noted in the following section. 
Other POKE possibilities are described in Appendix A. 

In the tables, the letter s stands for the slot number (1-7) in 
which the SSC is installed; the other letters are used as variables 
whose values are noted in the table (sometimes further down). 

There is no claim that making these changes is simple. In fact, 
whenever possible it is best to use Printer Mode and its software 
commands to change SSC operating variables. 

Here is an example of how to use the tables: let's say that the SSC 
is in slot #3. You want: a baud rate of 110; data format of 5 data 
bits and 2 stop bits, even parity; line width of 40 with video on, 
no automatic <LF> after <CR>; no translation of lowercase to 
uppercase; and no 1/4-second delay after <CR>. The PEEKs and POKEs: 



POKE 49339, 243 
POKE 49338, 107 
POKE 2043, 132 
POKE 1147, 64 



(49291 + 3*16; 3 + 240) 

(49290 + 3*16; p = 107) 

(plug in magic number) 

(plug in magic number) 



The same thing in Printer Mode with appropriate switch settings is: 

SW1-1 to SW1-7: ON ON OFF OFF OFF ON ON 
SW2-1 to SW2-7: — OFF ON ON OFF OFF OFF 
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Then to set 5 data and 2 stop bits, use <CTRL-I>7D<RETURN>; for 
even parity, use <CTRL-I>3P<RETURN>; to leave lowercase alone, use 
<CTRL-I>1T<RETURN>. You can use commands to change baud rate, etc. 



Selection 


SSC switches 

and settings 


PEEKS and POKES to use for 




P8 Serial Card 


Super Serial Card 




P8 Mode: 




SW1-5 ON, 

SW1-6 OFF 








P8A Mode: 




SW1-5 OFF, 

SW1-6 OFF 








Baud Rate 




SW1-1 to SW1-4 


POKE I 144+9, r 


POKE 49291+s*16,r 








same as Printer 


r = 


r = b + d; b - 




50 




Mode 


(not available) 


I dec/S01 hex 




75 






dec/$00 hex 


2 dec/S02 hex 




110 






176 dec/$B0 hex 


3 dec/$03 hex 




135 






144 dec/$90 hex 


4 dec/ $04 hex 




150 






128 dec/$80 hex 


5 dec/$05 hex 




300 






64 dec/$40 hex 


6 dec/$06 hex 




600 






32 dec/$20 hex 


7 dec/$07 hex 




1200 






16 dec/$10 hex 


8 dec/$08 hex 




1800 






11 dec/$0B hex 


9 dec/$09 hex 




2400 






8 dec/$08 hex 


10 dec/$0A hex 




3600 






5 dec/$05 hex 


11 dec/S0B hex 




4800 






4 dec/$04 hex 


12 dec/S0C hex 




7200 






(not available) 


13 dec/$0D hex 




9600 






2 dec/S02 hex 


14 dec/$0E hex 




19200 






1 dec/301 hex 


15 dec/S0F hex 




Data Format: 




POKE 1912+s,r 


(to get r above. 










POKE 127 2+s,t 


add d to b) d = 




8 data,l 


stop 


SW2-1 ON 


r = 9; E - 1* 


16 dcc/$l0 hex 




7 data.l 


stop 




r = 8; t - 1* 


48 dec/030 hex 




6 data, I 


stop 




r = 7; t - 1* 


80 dec/$50 hex 




5 data.l 


stop 




r = 6; t = 1* 


112 dec/$70 hex 




8 data, 2 


stop 


SW2-1 OFF 


r - 9; t - 2* 


144 dec/$90 hex 




7 data, 2 


s top 




r = 8; t - 2* 


176 dec/$B0 hex 




6 data, 2 


stop 




r = 7; t = 2* 


208 dec/$D0 hex 




5 data, 2 


stop 




r = 6; t - 2* 

* add 1 if 
p = 1 or 


240 dec/$F0 hex 




Parity: 






POKE 1400+s,p 


POKE 49290+s*16,p 




none 






P ■ 2 


p - 11 (S0B hex) 




odd 






p = 1 


p = 43 ($2B hex) 




even 






p = 


p - 107 ($6B hex) 




MARK 






(not available) 


(not available) 




SPACE 






(not available) 


(not available) 



Table B-l. SIC Switch Settings, PEEKs and POKEs, Part I 
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Selection 


SSC switches 
and settings 


PF.TK.s and P'iKY.S m „se for 


P8 Serial Card 


Super Serial Card 


Line Width: 


SW2-3 & SW2-4, 


POKE 1784+s,r 


POKE 1784+s,r 




same as Printer 


r=l to 255; 


r=40 to 255; for 




Mode 


for no <CR>,r-0 


no <CR>, PEEK 
1400+s, POKE 1400+s, 
(old value + 128) 


Video/ 


SW2-3 & SW2-4 


V = Video on? 


V - Video on? 


Cenerate <LF>/ 


SW2-5 


G = Gen. <LF>? 


G - Cen. <LF>? 


Translate/ 


(no switch) 


T = LC to UC? 




<CR> Delay: 


SW2-2 


D = Dly 1/4 s? 








POKE 2040+s,r 

r= 

dec hex V G T D 


POKE 2040+s,r 

r= 

dec hex V G 




(all switches 




same as in 


4 $04 Y N Y Y 


4 $04 N N 




Printer Mode) 


5 505 Y Y Y Y 


5 $05 N Y 






36 $24 Y N N Y 


132 $84 Y N 






37 $25 Y Y N Y 


133 $85 Y Y 






68 $44 Y N Y N 

69 $45 Y Y Y N 










100 $64 Y N N N 


T = LC to UC? 






101 $65 Y Y N N 


D ■ Dly 1/4 s? 






132 $84 N N Y Y 








133 $85 N Y Y Y 


POKE 1144+s,r 






164 $A4 N N N Y 


r = 






165 $A5 N Y N Y 


dec hex T D 






196 $C4 N N Y N 


0" W Y N 






197 $C5 N Y Y N 


16 $10 Y Y 






228 $E4 N N N N 


64 $40 N N 






229 $E5 N Y N N 


80 $50 N Y 



Table B-2. SIC Switch Settings, PEEKs and POKEs, Part II 

P8A EMULATION POKES 

The P8A ROM differs from the P8 ROM in several ways: 

1) The <CR> delay switch now determines whether an ETX/ACK handshake 
is performed after each <CR> that is transmitted. The corresponding 
RAM bit was not the same as the P8 <CR> delay bit, but was kept in 
bit 2 of location 1400+s. For SSC emulation, the control is the 
same as the <CR> delay bit as noted above (in location 1144+s). 

2) The number of stop bits was always 2; for SSC P8A mode this is 
configured via switch SW2-1 and can also be set via software by 
POKEing location 4929 as noted above. 

3) The printer width information was kept in the same location that 
the P8 ROM kept the number of stop bits; the P8 printer width byte 
was zeroed to avoid automatic generation of carriage returns. The 
SSC P8A emulation code keeps the printer width information in the 
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same place as for P8 emulation and uses the high-order bit at 
location 1400+s to control automatic generation of carriage returns. 

4) Lowercase input is enabled by default for the P8A ROM; in P8A 
emulation, however, it is enabled by the POKE shown in Table B-2. 

5) In contrast to the P8 ROM, the P8A ROM and the SSC do not 
support batch moves. 

6) The enquire character for the SIC P8A ROM was ETX (ASCII 3); for 
SSC P8A mode, this can be changed to another control character by a 
POKE to location 1400+s. For example, to change the enquire 
character to ENQ (ASCII 5), which is used by many RS-232 devices, 
use this POKE: POKE 1400+s, 5. Note that this also disables the 
automatic generation of carriage returns. Actually, any character 
between and 31 can be used, although only 3 and 5 are used much. 

OTHER EMULATION MODE DIFFERENCES 

If your old programs, written to control one of the old Serial 
Interface Card ROMs, still don't work after you've followed 
all this handy advice, then read on. 

The SSC always monitors the RS-232-C handshake lines to determine 
whether or not the device is ready to accept data. If your 
device fails to assert one of these lines, the SSC will wait 
patiently forever. 

When the arrow on the jumper block is pointing toward TERMINAL, your 
device sees DCD and DSR asserted as soon as the SSC is initialized, 
and the SSC sees CTS whenever the device sends RTS. If the device 
does not assert both RTS and DTR, the SSC will assume it is not 
ready to receive data. This can be used as a hardware handshake to 
prevent buffer overflow at the device (e.g., when your printer runs 
out of paper it can stop asserting one of these lines and the SSC 
will wait while you put in more paper). If you do not connect these 
lines, the SSC will always treat them as if they were asserted. 

The Serial Interface Card tied RTS to CTS, and DTR to DCD and DSR; 
if your RS-232 device depended upon this, you may want to make 
a special connector which does this. 

Your device may have depended upon the half-duplex nature of the 
SIC. The ACIA on the SSC is able to send and receive at the same 
time and is always configured to do so. 

The SIC was Initialized each time it was called at location $Cs00 
(for example, by a PR#s or IN#s). The SSC is only reintialized 
after the ACIA has been reset (either by resetting the Apple or by 
exiting from Printer or Communication Mode via a Reset command). 
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OLD COMMUNICATIONS CARD COMMANDS 

The SSC supports all the functions supported by the old Apple II 
Communications Interface Card (CIC), although the two ACIAs' 
registers are not the same on a bit-by-bit level. The SSC also 
supports the CIC commands: <CTRL-T>, <CTRL-R>, and <CTRL-S>. 

SWITCH TO TERMINAL MODE-<CTRL-T> 

In Communication Mode, the SSC is initialized to recognize the 
remote-control command <CTRL-T> arriving in the stream of incoming 
data. This character causes the SSC to enter Terminal Mode (the 
same as the T(erminal command (Chapter 3). You can disable <CTRL-T> 
recognition by issuing an X(OFF D(isable command. 

BYPASS TERMINAL MODE- < CTRL- R> 

When the SSC is in Terminal Mode and X(OFF E(nable (the default in 
this mode) is in effect, the SSC recognizes the remote control 
command <CTRL-R> arriving in the input data stream, and responds by 
bypassing (exiting from) Terminal Mode. This is the same as the 
Q(uit Terminal Mode command (Chapter 3). 

XOFF-<CTRL-S> 

The SSC interprets <CTRL-S> as the ASCII XOFF character. When it 
receives <CTRL-S> from a remote device, it stops transmitting data 
until it receives an XON character from that device. 



PARALLEL CARD COMMANDS 

The SSC is not hardware compatible with the Apple II Parallel Cards. 
However, for the sake of compatibility with software written for 
parallel interface applications, the SSC supports the following 
commands. You do not need to follow these commands with <RETURN>. 

LINE WIDTH n AND VIDEO OFF — <CTRL-IXn>N 

This command turns off the Apple II video screen and generates a 
<CR> after n characters (if automatic <CR> generation is enabled via 
the C command (Chapter 2); n can be any value from 40 through 255. 

LINE WIDTH 40 AND VIDEO ON-<CTRL-l>l 

This command turns on the Apple II video screen and sets the line 
width to 40. 

DISABLE AUTOMATIC LINEFEED- CTRL-IK 

This command has the same effect as L(inefeed D(isable (Chapter 2): 
it turns off automatic generation of <LF> after <CR>. 
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APPENDIX C 

SPECIFICATIONS 
AND SCHEMATICS 



This appendix contains the SSC specifications, connector pin 
assignments, jumper block wiring, and a schematic diagram. Use the 
schematic diagram with the Theory of Operation section in Chapter 4. 



SSC SPECIFICATIONS 



PHYSICAL CHARACTERISTICS 
Dimensions 
Weight 
Cables required 



Controls 

Special Tools 

ENVIRONMENT 

Operating temperature 
Storage temperature 
Operating relative humidity 
Storage relative humidity 



2-3/4" x 7" (68.8 mm x 177.8 mm) 
3 oz. (90 gm) , approximately 
Internal cable from 10-pin header 
on SSC to DB-25 connector on case 
of Apple II (supplied); shielded 
RS-232-C cable to external device 
(not supplied) 

2 blocks of 7 switches each, set 
by user before installation 
none required 



40 F to 95 F (5°C to 35° C) 
-40°F to 122° F (-40°C to 50°C) 
5% to 95% (noncondensing) 
5% to 95% (noncondensing) 



SPECIAL CIRCUITS 

SY6551 Asynchronous Communications Interface Adapter 

2316 Read Only Memory (2,048 by 8 bits) with SSC firmware 

The SSC has the usual power supply bypassing capacitors 
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APPLE II SLOT LOCATION 

BASIC programs 
APPLESOFT programs 
PASCAL programs 



SOFTWARE COMPATIBILITY 



any slot except slot #0 

any slot except slot #0 

slot tl for use with printer, etc. 

slot #2 for use with modem 

slot #3 for use with terminal 



The SSC is compatible with the following languages and operating 
systems : 



Integer BASIC 
Applesoft BASIC 



DOS 3.2 
nos 3.3 



Pascal 1.0 
Pascal 1.1 



6502 Assembler 



Under BASIC, input sent to the SSC at high baud rates may be lost, 
since the SSC can only buffer two characters at a time and BASIC may 
not be fast enough to read characters before they are overlaid. 

In any software environment, characters may be lost when sent to the 
video screen in scrolling mode at greater than 300 baud. There are 
at least three solutions to this problem: lower the baud rate to 
300 baud; reduce the scrolling window size (using 2 fewer lines 
already makes 1200 baud possible), or use an 80-column card with 
automatic hardware scrolling. 



CONNECTOR PIN ASSIGNMENTS 

Table C-l lists the signals assigned to the connector pins on the 
10-pin header at location 7B on the SSC, and the corresponding pins 
on the DB-25 connector that you attach to the back of the Apple II 
case. 



10-pin 


DB-25 










Header 


Connector 


Signal name 




1 


1 


Frame Ground 


i 


DB-25 


2 


2 


Transmit Data (TXD) 








3 


3 


Receive Data (RXD) 








4 


4 


Request To Send (RTS) 








5 


5 


Clear To Send (CTS) 








6 


6 


Data Set Ready (DSR) 








7 


19 


Secondary Clear To Send (SCTS) 








8 


7 


Signal Ground 








9 


20 


Data Terminal Ready (DTR) 








10 


8 


Data Carrier Detect (DCD) 


13 







25 



Table C-l. Connector Pin Assignments 
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JUMPER BLOCK WIRING 



Table C-2 lists the signals that the jumper block connects to the 
SSC when the arrow points toward the word MODEM and when it points 
toward the word TERMINAL. In the latter case, the jumper block acts 
as a modem eliminator. 

Note that all RS-232-C signals on the SSC use negative-true logic; 
that is, they are true (asserted) at volts and false at +5 volts. 



Signal at SSC 



MODEM 



position (pin) TERMINAL position (pin) 



Transmit Data 
Receive Data 
Request To Send 
Clear To Send 
Data Set Ready 
Data Terminal Ready 
Data Carrier Detect 
Data Carrier Detect 



Transmit Data (2) 
Receive Data (3) 
Request To Send (4) 
Clear To Send (5) 
Data Set Ready (6) 
Data Term. Ready (20) 
Data Carrier Detect (8) 
Data Carrier Detect (8) 



Receive Data (3) 
Transmit Data (2) 
Data Carrier Detect (8) 
Data Carrier Detect (8) 
Data Terminal Ready (20) 
Data Set Ready (6) 
Request To Send (4) 
Clear To Send (5)* 



*When SWl-7 is OFF and SW2-7 is ON, the jumper block in the TERMINAL 
position connects Data Carrier Detect on the SSC to Secondary Clear 
To Send on the DB-25 connector. 



Table C-2. Jumper Block Wiring 
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APPENDIX D 

ASCII CODE TABLE 



The table below shows Che entire ASCII character set, and how to 
generate each character. Not all characters are available directly 
from the Apple II keyboard. However, In Terminal Mode (Chapter 3) 
you can generate all of the lowercase and special ASCII characters 
not accessible directly from the Apple II keyboard. 

Here is how to interpret this table: 

• The BINARY column has the 7-bit code for each ASCII character. 

• The LOW DEC column gives the decimal equivalent of the 7-bit 
binary value. This value is the same if the binary code has 8 
bits and the high-order bit is (SPACE parity; Pascal). 

• The LOW HEX column gives the corresponding hexadecimal value. 

• The HI DEC column gives the decimal equivalent of the 7-bit 
binary value if a high-order bit equal to 1 Is appended to It 
(MARK parity; BASIC); for example, 11001000 for the letter H. 

• The HI HEX column gives the corresponding hexadecimal value. 

• The ASCII CHAR column gives the ASCII character name. 

• The INTERPRETATION column spells out the meaning of special 
symbols and abbreviations where necessary. 

• The WHAT TO TYPE column indicates what keystrokes generate 
the ASCII character from the NORMAL (unaided) Apple II 
keyboard, and from the TERMINAL Mode (firmware assisted) 
keyboard. Characters not accessible are labeled "n/a." 
The numbers between columns refer to footnotes. 

• Angle brackets enclose the names of single keys (like <ESC> 
for the ESC key), or enclose keystrokes involving more than 
one key (like <CTRL-SHIFT-M>, which means "hold down CTRL and 
SHIFT while pressing M.") But <ESC>9 means "type ESC, THEN 
type 9" because the 9 Is outside the angle brackets. 
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To put the SSC in Terminal Mode, set SW1-5 and SW1-6 both ON; then 
use the T command or the remote-control <CTRL-T> command. When the 
SSC first enters Terminal Mode, the keyboard is locked in uppercase. 
Press <ESC> once for lowercase. This also prepares the SSC for the 
special <ESO-plus-nuraber keystrokes. Press <ESC> twice in a row 
to lock the keyboard in uppercase again. 



7-BIT LOW LOW HI HI ASCII 

BINARY DEC HEX DEC HEX CHAR INTERPRETATION 



WHAT TO TYPE 
NORMAL TERMINAL 



0000001 
510 
911 
4100 

0000101 
0000110 
0000111 
0001000 
0001001 
0001010 
0001011 
0001100 
0001101 
0001110 
0001111 
0010000 
0010001 
0010010 
0010011 
0010100 
0010101 
0010110 
0010111 
0011000 
0011001 
0011010 
0011011 



1 01 



02 
03 
04 
05 
06 
07 



9 09 

10 0A 

11 0B 

12 0C 

13 0D 

14 0E 

15 0F 

16 10 

17 11 

18 12 

19 13 

20 14 

21 15 

22 16 

23 17 

24 18 

25 19 

26 1A 

27 IB 



128 80 NUL Blank (null) 

129 81 SOH Start of Header 

130 82 STX Start of Text 

131 83 ETX End of Text 

132 84 EOT End of Transra. 

133 85 ENQ Enquiry 

134 86 ACK Acknowledge 

135 87 BEL Bell 

136 88 BS Backspace 

137 89 HT Horizontal Tab 

138 8A LF Linefeed 

139 8B VT Vertical Tab 

140 8C FF Form Feed 

141 8D CR Carriage Return 

142 8E SO Shift Out 

143 8F SI Shift In 

144 90 DLE Data Link Escape 

145 91 DC1 Device Control 1 

146 92 DC2 Device Control 2 

147 93 DC3 Device Control 3 

148 94 DC4 Device Control 4 

149 95 NAK Neg. Acknowledge 

150 96 SYN Synchronization 

151 97 ETB End of Text Blk. 

152 98 CAN Cancel 

153 99 EM End of Medium 

154 9A SUB Substitute 

155 9B ESC Escape 



<CTRL-@> 

<CTRL-A> 

<CTRL-B> 

<CTRL-C> 

<CTRL-D> 

<CTRL-E> 

<CTRL-F> 

<CTRL-G> 

<CTRL-I1> 

<CTRL-I> 

<CTRL-J> 

<CTRL-K> 

<CTRL-L> 

<CTRL-M> 

<CTRL-N> 

<CTRL-0> 

<CTRL-P> 

<CTRL-Q> 

<CTRL-R> 

<CTRL-S> 

<CTRL-T> 11 

<CTRL-U> 12 

<CTRL-V> 

<CTRL-W> 

<CTRL-X> 

<CTRL-Y> 

<CTRL-Z> 

<ESC> 



9 

10 



13 <ESC>0 



1. Normal command character in Communication Mode. 

2. Used in ETX/ACK protocol (SIC P8A Emulation Mode). 

3. Used in ENQ/ACK protocol (SIC P8A Emulation Mode). 

4. Used in ETX/ACK or ENQ/ACK protocol (SIC P8A Emulation Mode). 

5. Or use -•— key. 

6. Normal Command character in Printer Mode. 

7. Or use <RETURN> key. 

8. XON in XON/XOFF protocol (usually in Communication Mode). 

9. Remote-control command to Exit from Terminal Mode. 

10. XOFF in XON/XOFF protocol (usually in Communication Mode). 

11. Remote-control command to Enter Terminal Mode. 

12. Or use — •• key. 

13. Use the ESC key to generate the Escape character with the normal 
Apple II keyboard. In Terminal Mode, use <ESC>0. 
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7-BIT LOW LOW HI HI ASCII WHAT TO TYPE 

RTNARY DEC HEX DEC HEX CHAR INTERPRETATION NORMAL TERMINAL 



0011100 

0011101 

0011110 

0011111 

0100000 

0100001 

0100010 

0100011 

0100100 

0100101 

0100110 

0100111 

0101000 

0101001 

0101010 

0101011 

0101100 

0101101 

0101110 

0101111 

0110000 

0110001 

0110010 

0110011 

0110100 

0110101 

0110110 

0110111 

0111000 

0111001 

0111010 

0111011 

0111100 

0111101 

0111110 

0111111 

1000000 

1000001 

1000010 

1000011 

1000100 

1000101 

1000110 

1000111 

1001000 

1001001 

1001010 

1001011 

1001100 

1001101 

1001110 



28 1C 

29 ID 

30 IE 

31 IF 

32 20 

33 21 

34 22 

35 23 

36 24 

37 25 

38 26 

39 27 

40 28 

41 29 

42 2A 

43 2B 

44 2C 

45 2D 

46 2E 

47 2F 

48 30 

49 31 

50 32 

51 33 

52 34 

53 35 

54 36 

55 37 

56 38 

57 39 

58 3A 

59 3B 

60 3C 

61 3D 

62 3E 

63 3F 

64 40 

65 41 

66 42 

67 43 

68 44 

69 45 

70 46 

71 47 

72 48 

73 49 

74 4A 

75 4B 

76 4C 

77 4D 

78 4E 



156 

157 

158 

159 

160 

161 

162 

163 

164 

165 

166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 

177 

178 

179 

180 

181 

182 

183 

184 

185 

186 

187 

188 

189 

190 

191 

192 

193 

194 

195 

196 

197 

198 

199 

200 

201 

202 

203 

204 

205 

206 



9C 

9D 

9E 

9F 

A0 

Al 

A2 

A3 

A4 

A5 

A6 

A7 

A8 

A9 

AA 

AB 

AC 

AD 

AE 

AF 

B0 

Bl 

B2 

B3 

B4 

B5 

B6 

B7 

B8 

B9 

BA 

BB 

BC 

BD 

BE 

BF 

C0 

CI 

C2 

C3 

C4 

C5 

C6 

C7 

C8 

C9 

CA 
CB 
CC 
CD 
CE 



FS 
GS 
RS 
US 
SP 
! 

II 

f 



> 

@ 

A 
B 

C 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 



Space 



File Separator n/a <ESC>1 

Group Separator <CTRL-SHIFT-M> 
Record Separator <CTRL-S1IIFT-N> 
Unit Separator n/a <ESC>2 

spacebar 
! 



Closing Quote 



Comma 

Hyphen 

Period 



( 
) 
* 

+ 



1 
2 
3 
4 
5 
6 
7 
8 
9 

; 
< 

> 
? 


A 
B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 
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7-BIT LOW LOW HI HI ASCII 

BINARY DEC HEX DEC HEX CHAR INTERPRETATION 



WHAT TO TYPE 
NORMAL TERMINAL 



51111 



0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 
1111 



1 

00010 
00011 
00100 
00101 
00110 
00111 
01000 
01001 
01010 
01011 
01100 
01101 
01110 
01111 
10000 
10001 
10010 
10011 
10100 
10101 
10110 
10111 
11000 
11001 
11010 
11011 
11100 
11101 
11110 
Hill 



79 4F 

80 50 

81 51 

82 52 

83 53 

84 54 

85 55 

86 56 

87 57 

88 58 

89 59 

90 5A 

91 5B 

92 5C 

93 5D 

94 5E 

95 5F 

96 60 

97 61 

98 62 

99 63 



100 
101 



110 
111 
112 



64 
65 



102 66 

103 67 

104 68 

105 69 

106 6A 

107 6B 

108 6C 

109 6D 



6F, 
6F 

70 



113 71 

114 72 

115 73 

116 74 

117 75 

118 76 

119 77 

120 78 

121 79 

122 7A 

123 7B 

124 7C 

125 7D 

126 7E 

127 7F 



207 


CF 














208 


D0 


P 






P 




209 


Dl 


Q 






Q 




210 


D2 


R 






R 




211 


D3 


S 






S 




212 


D4 


T 






T 




213 


D5 


U 






U 




214 


D6 


V 






V 




215 


D7 


W 






W 




216 


D8 


X 






X 




217 


D9 


Y 






Y 




218 


DA 


Z 






Z 




219 


DB 


[ 


Opening 


Bracket 


n/a 


<ESC>3 


220 


DC 


\ 


Re ve r s e 


Slant 


n/a 


<ESC>4 


221 


DD 


] 


Closing 


Bracket 


<SHIFT-M> 




222 


DE 


* 


Circumflex 


" 




223 


DF 




Underline 


n/a 


<ESC>5 


224 


E0 


' 


Opening 


Quote 


n/a 


15 


225 


El 


a 






n/a 


a 


226 


E2 


b 






n/a 


b 


227 


E3 


c 






n/a 


c 


228 


E4 


d 






n/a 


d 


229 


E5 


e 






n/a 


e 


230 


E6 


f 






n/a 


f 


231 


E7 


8 






n/a 


8 


232 


E8 


h 






n/a 


h 


233 


E9 


i 






n/a 


i 


234 


EA 


J 






n/a 


J 


235 


EB 


k 






n/a 


k 


236 


EC 


1 






n/a 


1 


237 


ED 


ra 






n/a 


ra 


238 


EE 


n 






n/a 


n 


239 


EF 


o 






n/a 





240 


F0 


P 






n/a 


P 


241 


Fl 


q 






n/a 


q 


242 


F2 


r 






n/a 


r 


243 


F3 


s 






n/a 


s 


244 


F4 


t 






n/a 


t 


245 


F5 


u 






n/a 


u 


246 


F6 


V 






n/a 


V 


247 


F7 


w 






n/a 


w 


248 


F8 


X 






n/a 


X 


249 


F9 


y 






n/a 


y 


250 


FA 


z 






n/a 


z 


251 


FB 


{ 


Opening 


Brace 


n/a 


<ESC>6 


252 


FC 


1 


Vertical Line 


n/a 


<ESC>7 


253 


FD 


> 


Closing 


Brace 


n/a 


<ESC>8 


254 


FE 




Overline (Tilde) 


n/a 


<ESC>9 


255 


FF 


DEL 


Delete/Rubout 


n/a 


<ESC>: 



5. Use Closing Quote (39). For high value, use CHR$(96), etc. 
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APPENDIX E 

TROUBLESHOOTING HINTS 



This appendix contains two tables designed to help you diagnose 
problems that can occur when using the SSC to communicate with an 
RS-232-C device. The device can be a printer, or a plotter, or 
terminal, or another computer, or some other Data Terminal Equipment 
(DTE), and It can be connected either directly, or via a modem or 
some other Data Communication Equipment (DCE). Whenever two DTEs 
are connected together, there must be TWO modems (DCEs) or ONE modem 
eliminator (such as the jumper block when it points toward the word 
TERMINAL) between them. 

When diagnosing problems, remember that there are many variables 
involved in the communications connection: 

• the Apple II and its keyboard, screen, and software 

• the SSC, the slot it is in, its switch settings (especially 
mode selection), its jumper block, cable, and software commands 

• the external cable, with some number of wires (enough wires?) 
connected to pins (all the correct pins?) at each end 

• possibly two modems connected by low-grade telephone lines, 
plus another cable from the remote modem to the remote device 

• an RS-232-C device at the other end, with its own switch 
settings and needs (such as paper, ribbon, AC power...) 

As you can see, making all these components work together correctly 
is no mean feat. If there are problems, the easiest way to resolve 
thera Is to start with very simple, sure communication between the 
Apple and the device. Once you have established basic communication 
(even if the characters are garbled), further troubleshooting 
becomes much easier. Be patient and methodical. 

Trouble usually has characteristics visible on the Apple II screen 
(Table E-l), or at the device (Table E-2). If your troubleshooting 
efforts fail, consult your Apple dealer — but first record all the 
variables (as outlined above) and the symptoms you observed. 
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Problem 


Symptom 


Possible Cause 


Solution 




no data 
trans f er 


no sign of 
any commu- 
nication 

at all 


cable wires not 
connected OK; 
jumper block 
facing wrong way 


check all cable connec- 
tions, then pin assign- 
ments; try reversing 
jumper block 




characters 
garbled 


jh2 3gXSQ 


wrong baud rate 


change SW1-1 TO SW1-4 or 
use <n>B command 




wrong data format 


change SW2-1 (and SW2-2 
in Comm Mode) or use <n>D 
command to change format 




other device is 
off, out of paper, 
etc., off-line 


turn on device, remedy 
its problems, put it 
on-line 




paper not 
advancing 


one line 
of smudge 


printer needs line 
feeds from SSC 


turn SW2-5 ON or use 
L(lnefeed E(nable command 




printer is 

skipping 

lines 


lines look 
like this 


printer and SSC 
both generating 
<LF> after <CR> 


turn off SW2-5 In Printer 
Mode, or use L(inefeed 
DCisable command 




missing 
characters 


msslg 
caractrs 


device buffer 
is overflowing 


If device supports full 
RS-232-C handshaking, en- 
sure all required cable 
wires are connected 

if device supports only 
ETX/ACK, set SIC P8A Mode 

if device supports XON/ 
XOFF, set Printer Mode 
and use X(OFF E(nable cmd 
or set Comm Mode 

If device supports none 
of these, set delays with 
<n>C, <n>L and <n>F crads 




device 
sticks at 
line's end 
going nuts 


one long 
OK line, 
smudge at 
right end 


device doesn't 
generate own <CR>, 
and isn't getting 
enough from Apple 


use SIC P8 Mode and <n>N 
command, or Printer Mode 
and C command plus appro- 
priate SW2-3 and SW2-4 

have software send <CR> 
before right margin 





Table E-l. Problems Detected at the Device 
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Problem 


Symptom 


Possible Cause 


Solution 


Apple has 


it works 


ACIA interrupting 


make sure that interrupt 


occasional 


one minute 


the Apple when DCD 


switch SW2-6 is OFF 


bad times 


& not next 


or DSR changes 




Apple not 


dead kybd 


SSC in slot #3 


Pascal expects external 


working 


and screen 


under Pascal 


terminal to run the show 


Apple kybd 


keystrokes 


echo off; keyboard 


use E(cho E(nable cmd; 


seems off 


all lost 


zapped; IN# not 


unzap with POKE; IN#0 


screen 


nothing 


device not echoing 


in Comm or Terminal Mode, 


s eems of f 


typed is 


(half duplex) or 


use F.(cho E(nable; in SIC 




displayed 


ACIA not sending 


or Printer Mode, use I 






to screen 


command or SW2-3 & -A ON 


screen is 


eevveerryy 


device & SSC both 


use E(cho D(isable cmd in 


seeing 


tthhlinngg 


echoing to Apple 


Comm Mode or use <n>N cmd 


double 


ttwwliccee 


(full duplex) 


in Printer Mode 


screen is 


lines look 


device generating 


use M(ask E(nable command 


spacing 




and sending <XF> 


to remove extra linefeeds 


double 


like this 


after <CR> 




forced 


lowercase 


Apple monitor 


use <n>T command to allow 


uppercase 


be COMES 


changing letters 


lowercase to pass through 


display 


UPPERCASE 


in GETLINE routine 


(not possible In Pascal) 


Apple 


pple 


screen scrolling 


turn off screen (<n>N or 


misses 


sses 


too slowly, or 


SW2-3 & -U in Prtr Mode); 


some 


ome 


BASIC or Pascal 


reduce scroll window; use 


characters 


racters 


program running 


assembly language or fas- 


at the 


t the 


too slowly, and 


ter program routines; use 


beginning 


bgnning 


so ACIA overruns 


lower baud rate (300 vs. 


of lines 


lines 




1200); use <n>C, <n>L or 
<n>F commands; in Comm 
Mode, chain (<n>S cmd) to 
80-column card with its 
own scrolling hardware 



Table E-2. Problems Detected at the Apple 
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APPENDIX F 

ERROR CODES 



The SSC uses I/O scratchpad address $678+s (s is che number of the 
slot that the SSC is in) to record status after a read operation. 
The firmware calls this byte STSBYTE. Table F-l lists the bit 
definitions of this byte: 



$678+s/T 




Status Byte (STSBYTE) 




/ 


6 


5 4 3 2 1 


\ 


1 
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Bit " 1" Means 

Parity Error occurred 

1 Framing Error occurred 

2 Overrun occurred 

3 Carrier lost 

5 Error occurred 



"0" Means 
No Parity Error occurred 
No Framing Error occurred 
Ho Overrun occurred 
Carrier present 
No error occurred 



Table F-l. STSBYTE Bit Definitions 

The terms Parity Error, Framing Error and Overrun are defined in the 
Glossary. 

Bits 0,1, and 2 are the same as the corresponding three bits of the 
ACIA Status Register (Appendix A). Bi t 3 indicates whether or not 
the Data Carrier Detect (DCD; Chapter 4) signal went false at any 
time during the receive operation. Rit 5 is set if any of the other 
bits are set, as an overall error indicator. If bit 5 is the only 
bit set, an unrecognized command was detected. If all bits are 0, 
no error occurred. 

In BASIC, you can check this status byte via a PEEK S678+S (s is the 
SSC slot), and reset it with a POKE command at the same location. 

In Pascal, the IORF.SULT function returns the error code value. 
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(<5^>) Any character — including Che carriage return at the end of a 
^ — S WRITELN statement — will cause posting of a new value in 
IORESULT. 

Table F-2 shows the possible combinations of error bits correspond to 
these decimal error codes. 



BASIC PEEK 


S678+S 


Carrier 




Framing 


Parity 


or Pascal 


IORESULT 


Lost 


Overrun 


Error 


Error 









(no error) 




32 






(illegal 


command) 




33 




no 


no 


no 


yes 


34 




no 


no 


yes 


no 


35 




no 


no 


yes 


yes 


36 




no 


yes 


no 


no 


37 




no 


yes 


no 


yes 


38 




no 


yes 


yes 


no 


39 




no 


yes 


yes 


yes 


40 




yes 


no 


no 


no 


41 




yes 


no 


no 


yes 


42 




yes 


no 


yes 


no 


43 




yes 


no 


yes 


yes 


44 




yes 


yes 


no 


no 


45 




yes 


yes 


no 


yes 


46 




yes 


yes 


yes 


no 


47 




yes 


yes 


yes 


yes 



1* 
E 
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Table F-2. Error Codes and Bits 

These error codes begin with the number 32 to avoid conflicting with 
previously defined and documented system error codes. 



110 SUPER SERIAL CARD 



3 

■ j 4 

- | 4 

- 1 
E 3 
fe! < 
t H 
ft H 
i M 
K 3 
ft 3 
* 3 

* ^ 

* 3 

£ 4 
£ 4 



To avoid lengthy or repetitive definitions, many terms used in one 
definition are themselves defined elsewhere in this glossary. Also 
for the sake of brevity, terms and expressions are spelled out, with 
their abbreviations immediately after them. In a glossary of this 
size, the reader will have little difficulty locating abbreviations. 



ACK: An ASCII character (decimal 6; Appendix D) sent from a device 
to the Apple II in response to an ETX or ENQ character in SIC 
P8A Emulation Mode. 

American Standard Code for Information Interchange (ASCII): A 
standard defining the codes to represent a 128-eleraent 
character set (Appendix D) in a fixed way for devices of 
different manufacturers. It is the standard for digital 
communication over telephone lines. 

Asserted: Made true (positive in positive-true logic; negative in 
negative-true logic). Usually refers to electrical signals, 
like the RS-232-C signal Clear To Send, etc. 

Asynchronous: Having a variable time interval between characters. 

Asynchronous Communications Interface Adapter (ACIA) : In the SSC, a 
single chip (Synertek 6551 or equivalent) that converts data 
from parallel to serial form and vice versa, and handles serial 
transmission and reception and RS-232-C signals, under the 
control of internal registers set and changed by SSC firmware. 

Baud: A unit of signalling speed equal to the number of discrete 
conditions or signal events per second. With the SSC, for 
example, using a data format of 1 start bit, 7 data bits, 1 
parity bit and 1 stop bit (10 bits in all), 300 baud is 
approximately equal to 30 characters per second. 

Binary: A number system with two digits, "0" and "1," with each 
digit position moving from right to left representing a 
successive power of two. For example, 1 represents decimal 1; 
10 represents 2; 100 represents 4; 1000 represents 8, etc. 

Bit: A Binary digiT, either a or a 1 . 
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BREAK: A 0.233 second SPACE (0) signal sent over a communication 

line to Interrupt the sender. This signal is often used to end 
a session with a timesharing service. 

Carriage Return (CR) : An ASCII character (decimal 13; Appendix D) 

that ordinarily causes a printer or display screen to place the 
subsequent character on the left margin. On a manual 
typewriter, this movement is combined with linefeed (the 
advancement of the paper to the next line). With computers, 
carriage return and linefeed are separate, causing hair-raising 
problems for the user. 

Carrier: The background signal on a communication channel that is 
modified to "carry" the information. Under RS-232-C, the 
carrier signal is equivalent to a continuous MARK or 1; a 
transition to then represents a start bit. 

Character: Any symbol that has a widely understood meaning. In the 
ASCII code, letters, numbers, punctuation marks, and so on, are 
all characters (Appendix D). 

Chip: A tiny wafer of silicon, with conductive metallic impurities, 
that has layers of microscopic circuits etched on it. 

Clear To Send (CTS) : An RS-232-C signal from a DCE to a DTE that 
the SSC keeps false until the DCE makes It true, indicating 
that all circuits are ready to transfer data. 

Command Character: An ASCII character, usually <CTRL-A> or 
<CTRL-I> (Appendix D), that causes the SSC firmware to 
interpret subsequent characters as a command. 

Command Register: An ACIA location (at hexadecimal address 
$C08A+s0) that stores parity type and RS-232-C signal 
characteristics. 

Communications Interface Card (C1C): An Apple 11 interface card 
designed to connect the Apple II to a device via a DCE. 

Communications Mode: An operating state In which the SSC Is 
prepared to exchange data and signals with a DCE. 

Control Character: Any character generated by holding down the key 
marked CTRL while pressing some other key. 

Control Register: An ACIA location (at hexadecimal address 

$C08B+s0) that stores data format and baud rate selections. 

Daisy Chaining: A method of passing Incoming signals and data from 
one peripheral connector slot to another, such as from the SSC 
slot to a slot containing an 80-column-dlsplay card. 

Data Bit: With the SSC, one of 5 to 8 bits representing a character. 
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Data Carrier Detect (DCD): An RS-232-C signal from a DCE to a DTE 
(such as the Apple II) indicating that a communication 
connection has been established. The SSC's internal circuits 
hold DCD false until the external device sets DCD true. 

Data Communication Equipment (DCE): As defined by the RS-232-C 

standard, any device that transmits or receives information. 
Usually this is a modem. However, when a Modem Eliminator is 
used, the Apple II looks like a DCE to the other device, and 
the other device looks like a DCE to the Apple. 

Data Conversion: Changing of data from parallel to serial form or 
from serial to parallel form. 

Data Format: The form In which data is stored, manipulated or 

transferred. Serial data transmitted and received by the SSC 
has a data format of: one start bit, 5 to 8 data bits, an 
optional parity bit, and one, one and a half, or two stop bits. 

Data Set Ready (DSR) : An RS-232-C signal from a DCE to a DTE 
indicating that the DCE has established a connection. 

Data Terminal Equipment (DTE): As defined by the RS-232-C standard, 
any device that generates or absorbs information, thus acting 
as a terminus of a communication connection. 

Data Terminal Ready (DTR) : An RS-232-C signal from a DTE to a DCE 
indicating a readiness to transmit or receive data. 

Default Value: A value that Is assumed or set In the absence of 
explicit instructions otherwise. 

Device: A piece of equipment; usually a printer, plotter, terminal 
or computer. When the jumper block is in the MODEM position, 
the SSC expects the device to be a DCE (such as a modem). 

Echo: To send an input character to a video screen, printer, or 
other output device. On a typewriter, what we strike on the 
keyboard appears on the page in the same step. With a 
computer, these two steps are controlled separately. 

Electromagnetic Interference (EMI): Electrical or magnetic signals 
or noise that disturbs the operation of radio or television 
receivers. For example, a hair dryer often creates EMI that 
fuzzes up the picture on a nearby television set. 

Emulation Mode: A manner of operating in which one computer or 

interface imitates another. For example, in SIC F8 Emulation 
Mode, the SSC acts very much like an Apple II Serial Interface 
Card with the P8 version of firmware. 

ENQ: An ASCII character (decimal 5; Appendix D) used in the ENQ/ACK 
protocol (SIC H8A Emulation Mode). 
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ETX: An ASCII character (decimal 3; Appendix D) used In the ETX/ACK 
protocol (SIC P8A Emulation Mode). 

Even Parity: Use of an extra bit set to or 1 as necessary to make 
the total number of 1 bits an even number. For example, the 
7-bit ASCII code for the letter A (1000001) has two 1 bits; for 
even parity, the transmitting device appends an eighth bit 
equal to so that the total number of 1 bits remains even. 
The receiving device can count 1 bits as a way of checking for 
transmission errors. 

False: Zero or negative voltage in positive-true logic; positive 

voltage in negative-true logic. Absence of an arbitrary signal 
or condition. 

Firmware (FW): Software that resides in ROM and so is relatively 
unchangeable (firm) compared to software in RAM. 

Form Feed (FF): An ASCII character (decimal 12; Appendix D) that 
causes a printer or other paper-handling device to advance to 
the top of the next page. 

Framing Error (FRM) : Absence of the expected stop bit(s) on a 

received character. The ACIA records this error by setting bit 
1 (FRM) of its Status Register to 1. The ACIA checks and 
records each framing error separately: if the next character 
is OK, the FRM bit is cleared. 

Full Duplex: Capable of simultaneous two-way communications. 

Half Duplex: Capable of communications in one direction at a time. 

Handshake : A kind of communication protocol in which the receiving 
device, when it has successfully gotten a character or block of 
characters, sends back an acknowledging signal, thereby 
triggering the next transmission. 

Hardware: The actual physical switches, wires, chips, PC boards, 
and so on, of a computer system. 

Header: A cable connector mounted on a PC board. 

Hexadecimal: A numbering system that uses 16 digits; usually these 
are represented by the ten decimal digits, through 9, plus 
the letters A through F (A representing decimal ten, F 
representing decimal fifteen, etc.). Each hexadecimal digit 
can represent a string of four binary digits. 

High-order Bit: See Most Significant Bit. 

Initialization: The process of setting up Initial values and 

conditions. In the SSC, the firmware finds out the switch 
positions and the current operating system, and uses these 
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findings to initialize both the ACIA registers and the 
Scratchpad RAM locations for the slot the SSC is in. 

■^ Input: Data that flows from the outside world into the Apple II. 

Interface: Some combination of hardware, firmware and software that 
makes possible the useful connection of two otherwise 
incompatible pieces of equipment. 

Interrupt: A special control signal from an external source that 
diverts the Apple II from the program it is executing to a 
specific routine that handles the condition (such as a printer 
gone awry) that caused the Interrupt. 

Jumper Block: In the SSC, a plastic plug with pins connected In 

such a way that It passes RS-232-C signals between the SSC and 
the external device either unchanged (MODEM position) or 
permuted in the manner of a Modem Eliminator (TERMINAL 
position). 

Least Significant Bit (LSB) : The right-hand bit of a binary number 
as written down; its positional value Is or 1 (that Is, or 
1 times 2 to the power). 

Linefeed (LF): An ASCII character (decimal 10; Appendix D) that 

ordinarily causes a printer or video display to advance to the 
next line. 

Local: Nearby; capable of direct connection using wires only. 



—* Low-order Bit: See Least Significant Bit. 
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MARK Parity: A bit of value 1 appended to the high-order end of a 
binary number for transmission. The receiving device can then 
check for errors by looking for this value on each character. 

Mode: Manner of operating. The SSC can operate In one of four 

chief modes, depending on the settings of switches SW1-5 and 
SW1-6: Printer Mode, Communications Mode, SIC P8 Emulation 
Mode, and SIC P8A Emulation Mode. 

Modem: MOdulator/DEModula tor; a DCE device that connects a DTE to 
communications lines. As used with the SSC, a device that 
exchanges RS-232-C signals witah the ACIA to establish a 
communications connection, and then either converts data from 
RS-232-C voltages to RS-232-C tones for transmission, or 
performs the opposite conversion on received data. 

Modem Eliminator: The physical crossing of wires that replaces a 

pair of modems for direct connection of two pieces of RS-232-C 
Data Terminal Equipment. In the SSC, the jumper block serves 
this purpose when installed in the TERMINAL position. 
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Most Significant Bit (MSB): The leftmost bit of a binary number as 
written down. This bit represents or 1 times 2 to the power 
one less than the total number of bits in the binary number. 
For example, in the binary number 10000, the 1 represents 1 
times 2 to the fourth power, or sixteen. 

Odd Parity: Use of an extra bit set to or 1 as necessary to make 
the total number of 1 bits an odd number. For example, the 
7-bit ASCII code for the letter A (1000001) has two 1 bits; for 
odd parity, the transmitting device appends an eighth bit equal 
to 1, making the total number of 1 bits odd. The receiving 
device can check for transmission errors by counting 1 bits. 

Output: Data that flows from the Apple II to an external device. 

Overrun (OVR) : A condition that occurs when the Apple II processor 
does not retrieve a received character from the Receive Data 
Register before the subsequent character arrives. The ACIA 
automatically sets bit 2 (OVR) of its Status Register; 
subsequent characters are lost. The Receive Data Register 
contains the last valid data word received. 

P8: One of two types of Programmable ROM (PROM) installed in the 
Apple II Serial Interface Card. This PROM performed batch 
moves, but had no provision for software handshaking. 

P8A: One of two types of Programmable ROM (PROM) installed in the 

Apple II Serial Interface Card. This PROM provided the ENQ/ACK 
software handshaking required by several types of printers. 

Parallel Interface: A connection between two devices where there is 
a separate wire for each bit of a character, so that an entire 
character can be transferred in a single Instant. 

Parity: Maintenance of a sameness of level or count, usually the 

count of 1 bits in each character, for error checking. In the 
SSC, the ACIA has a register that stores the type of parity 
selected (none, odd, even, MARK or SPACE). It automatically 
generates the parity bit when transmitting, and both checks and 
discards parity bits appended to received characters. 

Parity Error (PAR): Absence of the correct parity bit value in a 

received character. The ACIA records this error by setting bit 
(PAR) of its Status Register to 1. 

Peripheral Connector Slot: One of eight 50-pin slots inside the 

Apple II case near the back. Within certain restrictions, each 
slot can contain add-on memory, an adapter for 80-coluran 
display, or an interface to an external device. 

Polarized Header: On the SSC, a 10-pin female connector for 

the internal cable; this connector has a slot on one side that 
receives a "key" on the cable's male connector. 
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Printed Circuit (PC) Board: A sheet of stiff nonconduct ive material 
with one or more thin layers of metal bonded to it. Unwanted 
areas of this metal are etched away, leaving the paths of the 
desired circuits. Electronic components can then be soldered 
to the board. Small PC boards are also called cards. 

Printer Mode: An operating state in which the SSC is prepared to 

exchange data and signals with another DTE (such as a printer). 

Protocol: A predefined exchange of control signals between devices 
enabling them to prepare for coordinated data transfer. 

Radio Frequency Interference (RFI): Electromagnetic Interference 
occurring at frequencies used for radio communications. 

Random Access Memory (RAM): A series of storage locations that can 
be accessed directly (by means of horizontal and vertical 
coordinates) for both reading and writing. 

Read Only Memory (ROM): A series of storage locations that can be 
read but cannot be written to; this protects the programs and 
data in the ROM from alteration or destruction. 

Receive Data Register: A read-only register in the ACIA (at 

hexadecimal location SC088+S0) that stores the most recent 
character successfully received. 

Remote: Too distant for direct connection via wires or cables only. 

Request To Send (RTS) : An RS-232-C signal from a DTE to a DCK to 
prepare the DCE for data transmission. 

Ring Indicator (RI): An optional RS-232-C signal from a DCE to a 
DTE that indicates the arrival of a call. 

RS-232-C: A standard created by the Electronic Industries 

Association (EIA) to allow devices of different manufacturers 
to exchange serial data — particularly via telephone lines. The 
ACIA in the SSC implements all the required primary RS-232-C 
signals. These signals are true when at volts. 

Scratchpad RAM: Eight locations In the Apple's memory reserved for 
each of the 8 peripheral connector slots (64 bytes In all). 

Secondary Clear To Send (SCTS) : A secondary R5-232-C signal that 
some printers use instead of Clear To Send. 

Seria] Lnterface: A connection In which all the hits of a 

character are sent along a single wire one after the other. 

Serial Interface Card (SIC): An Apple II product designed to 
connect an RS-232-C device directly to the Apple II. 
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SIC Emulation Mode: A state of operation in which the SSC imitates 
an Apple II Serial Interface Card. 

SPACE Parity: A bit of value appended to a binary number for 

transmission. The receiving device can look for this value on 
each character as a means of error checking. 

Start Bit: A transition from a MARK signal to a SPACE signal for 
one bit-time, indicating that the next string of bits 
represents a character. 

Status Register: An ACIA register (hexadecimal location $C089+s0) 

that stores the state of two of the RS-232-C signals and of the 
Transmit and Receive Data Registers, as well as the outcome 
of the most recent character transfer. 

Stop Bit: A MARK signal following a string of data bits to indicate 
the end of a character. 

Super Serial Card (SSC): The interface card described in this 

manual. It is called "super" because it can simultaneously 
transmit and receive data in one of 35 formats at any of 15 
speeds, honor several software protocols, communicate directly 
with either DTE or DCE, change operating characteristics in 
response to software commands, and dovetail with the chief 
operating environments offered with the Apple II. 

Terminal: An input/output device, usually made up of a keyboard and 
video display and sometimes including its own printer and 
magnetic storage devices, that can act as a separate and even 
remote site for data transfer with a computer system. 

Terminal Mode: An operating state of the SSC in which the firmware 
bypasses the Apple II's central processor, and makes the Apple 
act as a simple terminal capable of generating all of the ASCII 
characters. 

Transmit Data Register: A write-only register In the ACIA (at 

hexadecimal location $C088+s0) that holds the current character 
to be transmitted. 

True: Positive voltage in positive-true logic; zero or negative 
voltage in negative-true logic. Assertion of an arbitrary 
signal or condition. 

XOFF: An ASCII character (decimal 19; Appendix D) sent by a 

receiving device to a transmitting device to halt transmission 
of characters. 

XON: An ASCII character (decimal 17; Appendix D) used in the 

XON/XOFF protocol as a go-ahead character from the receiving 
device to the sending device after an XOFF has been sent to 
halt transmission. 
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